Chat status
Appears as:chat.status, newChatStatus (system messages), template chatStatus, replyAction.chatStatus, and the statuses[] filter of Search Chats (which takes the names, not the numbers).
| Value | Name | Meaning |
|---|---|---|
0 | BOT | Handled by the bot |
1 | PENDING | Waiting for a human agent |
2 | ASSIGNED | Taken by an agent (shown as “Taken” in Texter) |
3 | RESOLVED | Conversation finished |
4 | BULK | Created/affected by a bulk send |
Message status
Appears as:message.status, statusHistory[].status, and messageStatus in the Message Status Changed webhook.
| Value | Meaning |
|---|---|
0 | Sent - sent from the platform |
1 | Accepted - accepted by the provider (e.g. Meta received it) |
2 | Delivered - delivered to the recipient’s device |
3 | Seen - read/opened by the recipient (blue ticks) |
4 | Failed - failed to deliver (e.g. invalid number) |
5 | Channel Failed - system/channel level failure |
6 | Deleted - message was deleted |
Channels
channelInfo.name, channel query filters, quick-reply targets, problem channel:
whatsapp · messenger · instagram · website_chat · email · sms
Message content types
message.type and the type of Send a Message to Chat bodies:
| Type | Direction | Content field |
|---|---|---|
text | both | text |
media | both | media[] |
contacts | both | contacts[] |
location | both | location |
buttons | outgoing | text + buttons[] |
list | outgoing | text + list |
postback | incoming | postback (the button/row the contact chose) |
special | both | special (channel-specific, e.g. template sends) |
Media types
media[].mediaType: image · video · document · audio · sticker (Sending supports image, video, document, audio; sticker appears on received messages.)
Template localization status
provider_template.localizations[].status:
| Status | Meaning |
|---|---|
REQUESTED | Submitted, waiting for WhatsApp |
SUBMIT_FAILED | Submission to WhatsApp failed |
PENDING | Under WhatsApp review |
APPROVED | Approved - can be sent |
REJECTED | Rejected by WhatsApp (see rejectionReason) |
DELETION_PENDING | Deletion requested, not yet final |
DELETED | Deleted at WhatsApp |
SUBMITTED | Accepted for processing |
Template category
provider_template.category: MARKETING · UTILITY - WhatsApp may recategorize on approval.
Quick reply display position
display.position: top · main
Scenario run step types
steps[].type in Scenario Runs: event · loader · condition · action · loop
Identifier cheat sheet
Which ID goes where - the most common source of confusion:| Identifier | Looks like | Where you get it | Where you use it |
|---|---|---|---|
Chat ID (chat._id) | 67bf11038b24880cc966f799 | Search Chats | Path of all /chats/{chatId} and /messages/*/{chatId} endpoints; quick-reply target[].id |
Contact ID (channelInfo.id) | 972521234567 | Chat/message objects | to when sending templates |
Account ID (channelInfo.accountId) | 972586640430 | Chat/message objects, Texter settings | from, template paths /whatsapp/templates/{accountId}, filters |
Provider message ID (message.channelInfo.id) | wamid.HBgMOTcy... | Message objects, webhook externalId | context when replying to a message |
Message ID (message._id) | 69062b15962e17ab3033f886 | Message objects | beforeId pagination cursor |
File ID (media[].fileId) | 6900c1eac29d42708adac92f | Message media items | Generate Public Media URL, re-sending media |
Bot session ID (botState.id) | 64-char hex | Chat botState / previousBotSession | botSessionId filter of Get Messages |
Template name (template.name) | bulk_marketing_272 | List All Templates | templateName when sending, template paths |
Label ID (label.id) | hot_lead | List All Labels | chat.labels, label filters, label management |
Scenario ID (scenario._id) | 6970b3c1d2e3f40123456789 | List All Subscriptions | Subscription manage endpoints |
| Agent UID | 4d170fc7-5cd6-... | chat.agent.uid, Chat Taken payloads | agentUid in Assign Chat |
| Department ID | customer_service | Texter settings | departmentId, template departments[] |