get https://{subdomain}.kommo.com/api/v4/talks/
O método permite obter dados de uma conversa específica por seu ID.
Limitações
O método está disponível para todos os usuários de uma conta. Os dados retornados variam dependendo das permissões definidas para o contato ao qual a conversa pertence.
Cabeçalho de resposta em caso de sucesso
Content-Type: application/hal+json
Cabeçalho de resposta em caso de erro
Content-Type: application/problem+json
Parâmetros de resposta
O método retorna um objeto de conversa.
| Campo | Tipo de dado | Descrição |
|---|---|---|
| talk_id | int | ID da conversa |
| created_at | int | Data de criação da conversa no formato Unix Timestamp |
| updated_at | int | Data de atualização da conversa no formato Unix Timestamp |
| rate | int | Avaliação da conversa pelo cliente (resultado do processamento pelo bot de NPS) |
| contact_id | int | ID do contato ao qual a conversa pertence |
| chat_id | string | ID de um chat ao qual a conversa pertence |
| entity_id | int/null | ID de uma entidade à qual a conversa pertence |
| entity_type | string/null | Tipo de entidade à qual a conversa pertence (lead) |
| is_in_work | bool | Indica se a conversa foi encerrada ou não |
| is_read | bool | Indica se a conversa foi lida |
| origin | string | Tipo de fonte para a qual a conversa foi criada (Telegram, Viber, etc.) |
| missed_at | int/null | Data em que a conversa foi perdida (nenhuma resposta dentro do tempo definido nas configurações da conta) no formato Unix Timestamp |
| account_id | int | ID da conta |
| _embedded | obj | Dados de entidades incorporadas |
| _embedded[contacts] | array | Dados dos contatos aos quais a conversa pertence (no máximo um) |
| _embedded[contacts][0] | obj | Modelo de um contato ao qual a conversa pertence |
| _embedded[contacts][0][id] | int | ID de um contato ao qual a conversa pertence |
| _embedded[leads] | array | Dados dos negócios sobre os quais a conversa trata (no máximo um) |
| _embedded[leads][0] | obj | Modelo de um negócio sobre o qual a conversa trata |
| _embedded[leads][0][id] | int | ID de um negócio sobre o qual a conversa trata |