Vai al contenuto
Sviluppatori

Endpoint

Messages

Send messages and WhatsApp templates as your business, and read message history.

I percorsi sono relativi all'URL di base. Ogni scheda indica il permesso richiesto dalla chiamata e ogni parametro, con tipo e limiti.

POST
/conversations/:id/messages

Send a message to the customer on the conversation's channel, as your business.

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

Corpo JSON

  • textopzionalestring

    Up to 4,096 characters. Send text, media_url, or both.

  • media_urlopzionalestring (URL)

    Public https:// URL of a file to attach, up to 2,048 characters.

  • media_typeopzionaleenum

    Required with media_url.

    Valori consentiti:imagevideoaudiodocument

  • pause_aiopzionaleboolean

    Also pause AI replies on the conversation. Default false.

  • Answers 201 with the message.
  • 422 outside_messaging_window when the channel does not allow a free-form message right now (for example after WhatsApp's 24-hour window — send a template instead).
  • 422 channel_not_supported or invalid_media_url; 502 channel_send_failed when the channel rejected the message (the error details include the stored message).
POST
/conversations/:id/whatsapp-template

Send an approved WhatsApp template. Works outside the 24-hour window.

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Conversation ID.

Corpo JSON

  • template_nameobbligatoriostring

    Template name from GET /whatsapp-templates, up to 512 characters.

  • languageobbligatoriostring

    Template language code, e.g. "en_US" (2–15 characters).

  • componentsopzionalearray of objects

    WhatsApp Cloud API template components (header/body/button parameters), up to 20. A JSON string is accepted too.

  • pause_aiopzionaleboolean

    Also pause AI replies on the conversation. Default false.

  • 422 not_whatsapp for a non-WhatsApp conversation; 422 whatsapp_not_connected when WhatsApp is not connected.
GET
/messages

List the messages of a conversation, newest first.

Permesso: inbox
Paginato

Parametri di query

  • conversation_idobbligatoriointeger

    The conversation to read.

GET
/messages/:id

Retrieve a message.

Permesso: inbox

Parametri del percorso

  • idobbligatoriointeger

    Message ID.

GET
/whatsapp-templates

List the workspace's WhatsApp message templates.

Permesso: inbox

Parametri di query

  • statusopzionalestring

    A template status such as APPROVED, PENDING or REJECTED, or "all". Default APPROVED.

  • 422 whatsapp_not_connected when WhatsApp is not connected; 502 whatsapp_unavailable when WhatsApp did not answer.