Enviar un mensaje

Sirve para enviar un mensaje de texto o un archivo a un contacto, indicando en el cuerpo el contact_id y el número desde el que sale.

POST
/message/send-message

Permiso requerido: conversations:send

Autorización

http
headerAuthorizationBearer <clave>

Cuerpo del pedido

application/json
  1. body
device_id*integer
text?string
contact_id*integer
file?string

Archivo del mensaje: el nombre de un archivo ya subido a tu cuenta o la URL pública de un archivo (te recomendamos https://), que WhatsApp o el proveedor descarga; admite hasta 4096 caracteres. Si empieza con http, en mayúsculas o minúsculas, tiene que ser una URL http:// o https://; si no, la respuesta es 422. Consulta la sección «Enviar un archivo por URL».

Patrón^(?:[Hh][Tt][Tt][Pp][Ss]?:\/\/.+|(?!\.\.?$)(?![Hh][Tt][Tt][Pp])[^\/\\\x00]+)$
Largolength <= 4096
file_type?|

Tipo del archivo. Es obligatorio cuando file es una URL que no termina en una extensión reconocida; si lo envías, manda sobre la extensión. Valores: image, video, audio, document, sticker. Consulta la sección «Enviar un archivo por URL».

Valor en"image""video""audio""document""sticker"null
file_name?|

Nombre con el que el contacto ve un documento, con su extensión (por ejemplo factura.pdf), de hasta 255 caracteres. Es obligatorio al enviar un documento por URL que no termina en una extensión de la lista. Consulta la sección «Enviar un archivo por URL».

Largo1 <= length <= 255
temporal_uuid?string
local_id?|
Largolength <= 255
note?boolean
client_reference?|
Patrón^[\x21-\x7E]{1,64}$
Largolength <= 64

Cuerpo de la respuesta

OK

application/json
  1. response
message*|null
curl -X POST "https://example.com/message/send-message" \  -H "Content-Type: application/json" \  -d '{    "device_id": 0,    "contact_id": 0  }'
{  "message": {    "id": 0,    "contact_id": 0,    "device_id": 0,    "direction": "outbound",    "type": "text",    "status": "sent",    "error": {      "code": 0,      "title": "string",      "reason": "string"    },    "client_reference": "string",    "created_at": "string",    "updated_at": "string"  }}