Mandar un mensaje a un contacto
Úsalo para enviarle a un contacto un mensaje de texto o un archivo desde uno de tus números, con opción de responder a un mensaje previo, sumar opciones o vista previa de link.
Permiso requerido: Contactos y conversaciones → Enviar
Si el límite de contactos activos (MAC) frena el envío, responde 429 con error = mac_lockout_24h o mac_limit_reached y sin Retry-After: reintentar no sirve hasta que sumes capacidad o empiece un ciclo nuevo. El envío no sale y no se guarda ningún mensaje ni tu client_reference: no queda nada en el historial del contacto. Detalle en «Errores y límites».
httpAuthorizationBearer <clave>contact*stringId opaco: un texto que empieza con ctc_. Se usa tal como llega; no se arma ni se interpreta.
^ctc_[A-Za-z0-9]{23}$application/json- body
phone?string1 <= lengthwhatsapp_id?string1 <= lengthdevice_id*stringId opaco: un texto que empieza con dev_. Se usa tal como llega; no se arma ni se interpreta.
^dev_[A-Za-z0-9]{23}$text?stringcontact_id*stringId opaco: un texto que empieza con ctc_. Se usa tal como llega; no se arma ni se interpreta.
^ctc_[A-Za-z0-9]{23}$file?stringArchivo 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».
^(?:[Hh][Tt][Tt][Pp][Ss]?:\/\/.+|(?!\.\.?$)(?![Hh][Tt][Tt][Pp])[^\/\\\x00]+)$length <= 4096file_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».
"image""video""audio""document""sticker"nullfile_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».
1 <= length <= 255temporal_uuid?stringnote?booleanmentions?array<integer>|items <= 50options?array<>1 <= items <= 10reference_message_uid?|length <= 255client_reference?|^[\x21-\x7E]{1,64}$length <= 64link_preview?booleanlink_preview_meta?OK
application/json- response
message*|nullcurl -X POST "https://example.com/contacts/ctc_AAOzYSKDiqHT4hM8LdPB8Ut/message" \ -H "Content-Type: application/json" \ -d '{ "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX", "contact_id": "ctc_AAOzYSKDiqHT4hM8LdPB8Ut" }'{ "message": { "id": "msg_As2pkZIkjmvC3nnoiFlYfDo", "contact_id": "ctc_AAOzYSKDiqHT4hM8LdPB8Ut", "device_id": "dev_Ac7Ku7iIZDXJTjdCu0UB1mX", "direction": "outbound", "type": "text", "status": "sent", "error": { "code": 0, "title": "string", "reason": "string" }, "client_reference": "string", "created_at": "string", "updated_at": "string" }}Atender una conversación
Responderle a un contacto por su id, marcar como leído un mensaje que te mandaron, mostrar «escribiendo…», reaccionar a un mensaje, reenviar un mensaje, mandar una tarjeta de contacto, y ver tus formularios de WhatsApp y mandar uno.
Marcar un mensaje como leído POST
Úsalo para marcar como leído un mensaje que te mandó un contacto: ve el doble check azul y, en Funnelchat, la conversación queda leída. No manda ningún mensaje.