Messages

Leer y enviar mensajes dentro de una conversación.

GET/v1/messagesconversations:read

Mensajes públicos de una conversación.

CampoTipoDescripción
conversation_idrequeridostringId de la conversación.
POST/v1/messagesconversations:write

Envía un mensaje como miembro del equipo.

CampoTipoDescripción
conversation_idrequeridostringConversación destino.
bodyrequeridostringTexto del mensaje, hasta 5000 caracteres.
internalbooleanSi es true, queda como nota interna y el cliente no la ve.
GET/v1/conversations/{id}/messagesconversations:read

Mismos mensajes, anidados bajo la conversación.

CampoTipoDescripción
include_internalbooleanIncluye las notas internas del equipo.
POST/v1/conversations/{id}/messagesconversations:write

Responde en la conversación sin repetir el id en el cuerpo.

CampoTipoDescripción
bodyrequeridostringTexto del mensaje, hasta 5000 caracteres.
internalbooleanSi es true, queda como nota interna.
author_idstringMiembro 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.