Get a WhatsApp conversation
/v1/whatsapp/conversations/{conversation_id}const conversation = await bird.whatsapp.conversations.get("wacv_01krdgeqcxet5s7t44vh8rt9mg");
console.log(conversation.control, conversation.assigned_to, conversation.labels);conversation = client.whatsapp.conversations.get("wacv_01krdgeqcxet5s7t44vh8rt9mg")
print(conversation.control, conversation.assigned_to, conversation.labels)conversation, err := client.Whatsapp.Conversations.Get(context.Background(), "wacv_01krdgeqcxet5s7t44vh8rt9mg")
if err != nil {
log.Fatal(err)
}
fmt.Println(conversation.Control, conversation.Labels)$conversation = $bird->whatsapp->conversations->get('wacv_01krdgeqcxet5s7t44vh8rt9mg');
echo $conversation->getControl(), ' ', $conversation->getAssignedTo() ?? 'unassigned';bird whatsapp conversations get <conversation-id>curl -X GET "https://us1.platform.bird.com/v1/whatsapp/conversations/{conversation_id}" \
-H "Authorization: Bearer $TOKEN"{
"id": "wacv_01krdgeqcxet5s7t44vh8rt9mg",
"business_phone_number": "+15550001234",
"recipient": {
"bsuid": "US.13491208655302741918",
"phone_number": "+15550001111",
"display_name": "Jamie Rivera",
"username": "jamierivera"
},
"inbox_status": "open",
"control": "bird",
"assigned_to": "usr_01krdgeqcxet5s7t44vh8rt9mg",
"service_window": {
"status": "open",
"ends_at": "2026-09-23T10:35:00Z"
},
"last_message": {
"id": "wam_01krdgeqcxet5s7t44vh8rt9mg",
"direction": "outbound"
},
"labels": [
"billing",
"vip"
]
}
Returns one conversation's current state: who answers it right now, when its customer-service window closes, how many messages are unread, its labels, and its most recent message.
Resolving inbox work preserves the conversation. New inbound messages reopen it with the same ID. Messages are retained for 30 days. When the last one expires, the conversation and its events are deleted, and this returns 404.
Parametri
conversation_idstringConversation identifier. Starts with wacv_.
Payload di risposta
idConversation ID.
business_phone_numberYour WhatsApp business phone number this conversation runs on, in E.164 format. It stays the same when you remove the number and connect it again. Null when Bird holds no phone number for it.
recipientThe other side of the conversation: the contact, or the group it takes place in. A group conversation carries group_id and null contact identity fields.
inbox_statusWhether the conversation needs attention in the workspace inbox. Set it to resolved when the work is finished. A new inbound message reopens the same conversation. Changing inbox status preserves message history and does not change the channel's permission to send messages or mark messages read.
Possible values: open, resolved
controlWho answers this conversation right now. You take and release control in the dashboard inbox.
Possible values (may grow over time): bird, meta_business_agent
assigned_toThe user this conversation is assigned to. Null when unassigned. Assignment is not rechecked against workspace membership on read, so it can still name a user whose access was removed.
service_windowCustomer-service window for a contact. Null for group conversations.
last_messageA pointer to the most recent message in this conversation. It names the message; read its content through the conversation's message list. Null when the conversation has no message yet.
unread_countNumber of inbound messages the workspace has not acknowledged. Shared across the workspace. Sending a reply does not mark messages read.
labelsWorkspace labels on this conversation. Labels do not change read state or inbox status.
created_atWhen Bird opened this conversation.
updated_atWhen this conversation last changed.
Risorse correlate
Continua con la documentazione, le guide e gli esempi per questo argomento.