Webhooks
Abonniere Ereignisse mit POST /v1/webhook-subscriptions. SmartChat schickt dann zu jedem Ereignis einen signierten POST an deine Adresse. Jede 2xx-Antwort bestätigt die Zustellung.
Die technische Referenz unten ist auf Englisch, genau so, wie Namen und Felder in der API und in Claude erscheinen.
curl -X POST https://api.smartchat.marketing/v1/webhook-subscriptions \
-H "Authorization: Bearer sk_live_..." \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com/hook", "events": ["contact.created"]}'contact.created
A contact was created
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | nein | Unique event id, e.g. "message.received:<uuid>". Equals X-SmartChat-Delivery. |
event | string ("contact.created", "message.received", "conversation.created") | nein | |
created_at | string | nein | format date-time |
data | object | nein | |
data.id | string | nein | format uuid |
data.name | string | nein | |
data.email | string | nein | Empty string "" if none. |
data.phone | string | nein | E.164; empty string "" if none. |
data.optin_whatsapp | string ("none", "pending", "confirmed", "opted_out") | nein | |
data.optin_email | string ("none", "pending", "confirmed", "opted_out") | nein | |
data.tags | array of string | nein | |
data.language | string | nein | |
data.source | string | nein | |
data.created_at | string | nein | There is no updated_at on contacts. format date-time |
message.received
An inbound message was received
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | nein | Unique event id, e.g. "message.received:<uuid>". Equals X-SmartChat-Delivery. |
event | string ("contact.created", "message.received", "conversation.created") | nein | |
created_at | string | nein | format date-time |
data | object | nein | Item of GET /messages; also the data of the message.received webhook event. |
data.id | string | nein | format uuid |
data.conversation_id | string | nein | format uuid |
data.contact_id | string | nein | format uuid |
data.channel | string | nein | whatsapp, email, ... |
data.direction | string ("inbound", "outbound") | nein | |
data.type | string | nein | text, or a media type: image, video, audio, document, sticker, ... |
data.text | string | nein | |
data.media_url | string | nein | |
data.media_mime | string | nein | |
data.created_at | string | nein | format date-time |
conversation.created
A conversation was created
| Feld | Typ | Pflicht | Beschreibung |
|---|---|---|---|
id | string | nein | Unique event id, e.g. "message.received:<uuid>". Equals X-SmartChat-Delivery. |
event | string ("contact.created", "message.received", "conversation.created") | nein | |
created_at | string | nein | format date-time |
data | object | nein | |
data.id | string | nein | format uuid |
data.contact_id | string | nein | format uuid |
data.channel | string | nein | |
data.created_at | string | nein | format date-time |
Fragen?
Schreib uns an support@smartchat.marketing