Resource model
| Resource | Purpose |
|---|---|
| Workspace | Tenant boundary for every other resource. |
| Contact | A customer identity with attributes and tags. |
| Conversation | A thread of messages on a channel. |
| Message | A single inbound or outbound message. |
| Call | A voice interaction with transcript and outcome. |
Error semantics
Planned error shape
{
"error": {
"type": "invalid_request",
"message": "contact.phone must be in E.164 format",
"param": "contact.phone",
"request_id": "req_01H..."
}
}Always log the request identifier. It is the fastest way for support to trace a failing call.