Saltar al contenido principal
GET
Returns the details of a specific conversation thread, including its channel, contact, status, assignee and, when the conversation started from a Meta ad or post, its referral.

Headers

string
requerido
Your API key for authentication.

Path Parameters

string
requerido
The UUID of the thread to retrieve.

Response

string
Unique identifier of the thread (UUID).
string
UUID of the channel this thread belongs to.
string
Type of the channel (e.g. WABA, INSTAGRAM).
string
UUID of the contact in this thread.
string
UUID of the organization that owns this thread.
string
Thread status (e.g. open, closed).
string
UUID of the user or agent currently assigned to this thread.
string
Type of the assignee: user or agent.
string
Timestamp when the thread was created (ISO 8601).
string
Timestamp of the last update (ISO 8601).
object | null
Where the conversation came from, as Meta reported it in the contact’s first message. Present when someone wrote from a Click-to-WhatsApp ad, a post or a page; null for organic conversations. Fields Meta did not send are left out, so check each one before using it.
image_url, video_url and thumbnail_url are signed Meta URLs and expire after a few days. Download the media when you receive it if you need to keep it; don’t store the URL.

Ad attribution with the Conversions API

referral.ctwa_clid is the identifier Meta asks for to attribute a conversion from a WhatsApp conversation to the ad that started it. When the contact converts (a lead, a purchase), send the event to the Conversions API of your dataset with:
  • action_source: business_messaging
  • messaging_channel: whatsapp
  • user_data.ctwa_clid: the ctwa_clid of the thread
  • user_data.whatsapp_business_account_id: the ID of your WhatsApp Business account
referral.source_id is the ad ID: use it to match the conversation with the ad’s results in Ads Manager.

Error Codes

  • 401 Unauthorized — Invalid or missing API key
  • 404 Not Found — Thread not found or does not belong to your organization
  • 500 Internal Server Error — Server-side error

Code Examples