Quickstart

Go from zero to an AI persona answering FaceTime in about 10 minutes.

1. Sign in and get your keys

1. Sign in with your account email and password. Use Forgot password to receive a password reset email if needed.
2. Open Developer → Project API keys and select Create read/write key.
3. Copy the ftk_… secret. It is shown exactly once, for at most one minute.
4. Note the Project ID shown in Developer.

export CHERT_API_KEY=ftk_...
export PROJECT_ID=5ee3afd6-...
export BASE=https://facetime.trychert.com/api

2. Verify connectivity

curl $BASE/health
# → { "status": "ok", "database_ready": true }

3. Create an assistant

curl -X POST $BASE/v1/assistants \
  -H "Authorization: Bearer $CHERT_API_KEY" \
  -H "X-Chert-Project-Id: $PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Front Desk",
    "system_prompt": "You are a friendly, concise concierge for Acme Inc...",
    "greeting": "Hi! Thanks for calling Acme, how can I help today?",
    "avatar_id": "anam_persona_abc123"
  }'

4. Publish and assign it

curl -X POST $BASE/v1/assistants/{assistant_id}/publish \
  -H "Authorization: Bearer $CHERT_API_KEY" \
  -H "X-Chert-Project-Id: $PROJECT_ID"

curl -X POST $BASE/v1/lines/{line_id}/assign \
  -H "Authorization: Bearer $CHERT_API_KEY" \
  -H "X-Chert-Project-Id: $PROJECT_ID" \
  -H "Content-Type: application/json" \
  -d '{ "assistant_id": "{assistant_id}" }'

5. Call it

FaceTime the line’s handle from an iPhone, iPad, or Mac. The call auto-answers within seconds. Video callers see a branded connecting screen while the persona initializes, normally 5–10 seconds, before the avatar greets them. The completed call appears under Calls.