# messages (GET)

Retorna uma lista de mensagens acumuladas (tanto de e para os clientes) Se Viber Business,ViberPublicouLivechat (widget)são usados, status de entrega também são retornados. 

Importante! Não use esse método muito frequentemente com o número alto de registro de números (limite). Você atingirá o limite de requisições da API muito rápido. Use webhooks, no lugar. 

Adicionalmente, o parâmetro start\_id agora substitui o parâmetro offset para reduzir a carga sobre o servidor. 

Request:

![](/files/KdMUobgnGhEItyCekZSy)

Parâmetros: 

• \<id> – id da mensagem.&#x20;

Quando esse commando é usado sem \<id> ele retorna uma lista de todas as mensagens acumuladas. Quando \<id> é especificado, o comando retorna informação adicional sobre a mensagem especificada, incluindo dialog\_id, operator\_id e channel\_id.&#x20;

Ao requisitar uma lista de mensagems, os seguintes filtros são suportados:&#x20;

• transport&#x20;

• channel\_id&#x20;

• client\_id&#x20;

• type (to\_client, from\_client, autoreply or system) (para o cliente, do cliente, resposta automática ou do sistema)&#x20;

• dialog\_id&#x20;

• read (lida ou não por um operador)&#x20;

• order (asc ou desc) – ordem de registros retornados. O padrão é ordem crescent.&#x20;

• start\_date & finish\_date – período de tempo&#x20;

• operator\_id – id do operador&#x20;

• start\_id New – retorna array de mensagens, começando de um message\_id particular (mensagens com id ⩾ start\_id)&#x20;

Exemplo de request com filtros:

![](/files/O0nAByEK1a4C2ZYlVKsy)

Alguns campos na resposta:

• coordinates – geocoordenadas.&#x20;

• type:&#x20;

o from\_client – uma mensagem do cliente.&#x20;

o to\_client – uma mensagem para o cliente.&#x20;

o system –mensagem do sistema (como “conversa atribuída…”).Tal mensagem não é enviada para o cliente. o autoreply – resposta automática para um cliente ou mensagem do menu.&#x20;

• read – status: lido ou não pelo operador.&#x20;

• created – data da criação de mensagem (UTC).&#x20;

• recipient\_status – informações sobre o status da entrega da mensagem (agora aplica-se apenas a Viber Business/Public, conta do WhatsApp Business API e Live chat).&#x20;

• attachments– array de anexos na mensagem com nome e link de cada arquivo. Para compatibilidade retroativa, alguns tipos de anexo são retornados adicionalmente em campos separados foto, vídeo e áudio.&#x20;

• insta\_comment – verdadeiro para Mensagem de comentário do Instagra;&#x20;

• extra data – pode conter informação adicional, como : o id externo passado via messages/inbox (POST);&#x20;

o post\_url -link para o post de comentários do Instagram&#x20;

Resposta típico:

![](/files/riCEufiCrVnlqr13Y8WE)

![](/files/luqAlpqNZQBuXcrvi39g)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://c2dbr-pt.gitbook.io/c2dbr/api-and-webhooks/messages-get.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.