Conceituação
Conforme já falamos no tópico anterior, para o WhatsApp tudo é um chat. Neste tópico você vai encontrar todos os métodos para buscar informações e gerenciar seus chats. Um chat no WhatsApp pode ser:- Conversa individual — chat com um contato específico, identificado pelo número de telefone;
- Grupo — chat com múltiplos participantes, identificado por um ID único;
- Lista de transmissão — envio para múltiplos contatos ao mesmo tempo, identificada por um ID com prefixo “broadcast”.
O que você pode fazer com chats?
Através da Z-API, você tem acesso a diversos métodos para gerenciar seus chats:Listar chats
Obtenha todos os chats abertos com informações como última mensagem, timestamp e dados do contato/grupo.
Metadata do chat
Busque informações detalhadas de um chat específico, incluindo mensagens.
Marcar como lido
Marque um chat inteiro como lido, similar ao que você faz manualmente no WhatsApp.
Arquivar e fixar
Organize seus chats arquivando ou fixando conversas importantes.
Mutar chat
Silencie notificações de um chat específico.
Limpar e deletar
Limpe o histórico de mensagens ou delete um chat completamente.
Identificadores de chat
É importante entender como o WhatsApp identifica cada tipo de chat:| Tipo | Formato do ID | Exemplo |
|---|---|---|
| Contato | Número de telefone | 5511999999999 |
| Grupo | Número + timestamp | 5511999999999-1234567890@g.us |
| Lista de transmissão | broadcast + timestamp | broadcast-1234567890 |