Funnelchat APIEnviar un mensaje a un contacto
Usalo 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: conversations:send
httpAuthorizationBearer <clave>contact*integerapplication/json- body
phone?string1 <= lengthwhatsapp_id?string1 <= lengthdevice_id*integertext?stringcontact_id*integerfile?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?booleanoptions?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/0/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" }}Actualizar la conversación de un contacto PUT
Sirve para gestionar la conversación con un contacto: asignarla a un asesor, abrirla o cerrarla, marcarla como favorita o no leída, o cambiar el número que la atiende.
Listar los mensajes de un contacto GET
Sirve para traer el historial de mensajes de un contacto y mantenerlo sincronizado en tu sistema, con paginación por cursor y updated_since para pedir solo lo nuevo.