Messages
Leer y enviar mensajes dentro de una conversación.
GET
/v1/messagesconversations:readMensajes públicos de una conversación.
| Campo | Tipo | Descripción |
|---|---|---|
conversation_idrequerido | string | Id de la conversación. |
POST
/v1/messagesconversations:writeEnvía un mensaje como miembro del equipo.
| Campo | Tipo | Descripción |
|---|---|---|
conversation_idrequerido | string | Conversación destino. |
bodyrequerido | string | Texto del mensaje, hasta 5000 caracteres. |
internal | boolean | Si es true, queda como nota interna y el cliente no la ve. |
GET
/v1/conversations/{id}/messagesconversations:readMismos mensajes, anidados bajo la conversación.
| Campo | Tipo | Descripción |
|---|---|---|
include_internal | boolean | Incluye las notas internas del equipo. |
POST
/v1/conversations/{id}/messagesconversations:writeResponde en la conversación sin repetir el id en el cuerpo.
| Campo | Tipo | Descripción |
|---|---|---|
bodyrequerido | string | Texto del mensaje, hasta 5000 caracteres. |
internal | boolean | Si es true, queda como nota interna. |
author_id | string | Miembro que figura como autor. Por defecto, la integración. |
Firmar el mensaje con una persona real
Sin author_id el mensaje aparece como enviado por la integración. Pasando el id de un miembro, el cliente ve el nombre y la foto de esa persona, igual que si hubiera escrito desde el Inbox.
Si el id no pertenece al workspace devolvemos 422 en vez de atribuir el mensaje a nadie.
Terminal
curl -X POST https://api.tinkay.app/v1/conversations/cv_1832/messages -H "Authorization: Bearer dk_live_xxx" -H "Content-Type: application/json" -d '{ "body": "Ya despachamos tu pedido.", "author_id": "mem_tomas" }'Enviar un mensaje
curl -X POST https://api.tinkay.app/v1/messages \ -H "Authorization: Bearer dk_live_xxx" \ -H "Content-Type: application/json" \ -d '{ "conversation_id": "cv_1832", "body": "Ya activamos tu cuenta. Cualquier cosa, escribinos." }'Los mensajes creados por API aparecen en el Inbox como enviados por el equipo, con la marca de origen api.
