get
https://{subdominio}.kommo.com/api/v4/talks//messages
El método permite recuperar los mensajes de una conversación.
Limitaciones
- El método está disponible de acuerdo con los permisos del usuario.
- El método está disponible para los planes de Prueba, Pro, Empresarial y Técnico.
- El método requiere el alcance de intregación
Historial de chats externos.
Encabezado del tipo de datos cuando la solicitud se realiza correctamente
Content-Type: application/hal+json
Encabezado del tipo de datos en caso de error
Content-Type: application/problem+json
Parámetros de respuesta
| Parámetro | Tipo de dato | Descripción |
|---|---|---|
| id | string | ID del mensaje. |
| chat_id | string | ID del chat. |
| type | string | Dirección del mensaje. Valores posibles: incoming, outgoing. |
| message_type | string | Tipo de contenido del mensaje. Valores posibles: text, contact, file, video, picture, voice, audio, sticker, location. |
| author | obj | Objeto del autor del mensaje. |
| author[id] | string | ID del autor. |
| author[type] | string | Tipo de autor. Valores posibles: internal (usuario de Kommo), external (cliente), bot (bot de Kommo). |
| author[name] | string | Nombre para mostrar del autor. |
| author[avatar_url] | string | URL del avatar del autor. |
| author[user_id] | int | ID del usuario de Kommo. Solo se retorna cuando author[type]: internal. |
| recipient | obj | Objeto del destinatario del mensaje. |
| recipient[id] | string | ID del destinatario. |
| recipient[type] | string | null | Tipo de destinatario. Valores posibles: external (client). |
| recipient[name] | string | Nombre para mostrar del destinatario. |
| recipient[avatar_url] | string | URL del avatar del destinatario. |
| text | string | Texto del mensaje. Vacío para los mensajes sin contenido de texto. |
| created_at | int | Hora de creación del mensaje como Unix Timestamp (segundos). |
| sec_created_at | int | Hora de creación del mensaje como Unix Timestamp (milisegundos). |
| origin | string | Canal de chat del mensaje. |
| delivery_status | string | Estado de entrega del mensaje. Valores posibles: sent, delivered, error. |
| attachment | obj | null | Objeto del archivo adjunto. |
| attachment[type] | string | Tipo de archivo adjunto. |
| attachment[link] | string | Ruta o URL del archivo adjunto. |
| attachment[file_name] | string | Nombre del archivo adjunto. |