Resumo
Wati fornece um conjunto de APIs que ajudam você a interagir com o WhatsApp programaticamente. Você pode usar essas APIs para enviar e receber mensagens, gerenciar contatos, manipular mídia e integrar o Wati com seus sistemas existentes. Este guia oferece uma visão geral clara das APIs disponíveis e do que cada uma faz, para que você possa começar rapidamente.
Instruções
APIs Disponíveis
Com o Wati, você pode acessar várias APIs agrupadas por funcionalidade.
APIs de Mensagens
Use essas APIs para enviar e receber mensagens no WhatsApp.
Obter mensagens do número do WhatsApp - Recupere mensagens recebidas no seu número do WhatsApp.
Enviar mensagem de sessão - Envie uma mensagem dentro de uma sessão ativa do WhatsApp.
Enviar arquivo de sessão - Envie um anexo de arquivo dentro de uma sessão ativa.
Enviar mensagem de modelo - Envie uma mensagem de modelo do WhatsApp pré-aprovada.
Enviar mensagens de modelo (em massa) - Envie várias mensagens de modelo de uma só vez.
Enviar mensagem de modelo usando CSV - Carregue um arquivo CSV para enviar mensagens de modelo em massa.
Enviar mensagem de botão interativo - Envie mensagens com botões clicáveis para respostas rápidas.
Enviar mensagem de lista interativa - Envie mensagens com uma lista selecionável de opções.
APIs de gerenciamento de contatos
Use essas APIs para gerenciar seu banco de dados de contatos.
Obter lista de contatos - Recupere todos os contatos armazenados no Wati.
Adicionar contato - Crie um novo contato.
Atualizar atributos de contato - Modifique os detalhes de um contato existente.
APIs de mídia e autenticação
Use essas APIs para gerenciar arquivos e proteger o acesso.
Obter mídia por nome de arquivo - Recupere os arquivos de mídia usando seus nomes de arquivo.
Girar token - Atualize seu token de autenticação para manter o acesso seguro à API.
APIs de operador e atribuição
Use essas APIs para gerenciar a propriedade e o roteamento do chat.
Atribuir operador - Atribua uma conversa do WhatsApp a um operador específico.
Onde posso encontrar o endpoint da API e o token de acesso?
Para acessar os detalhes da sua API no Wati:
1. Faça login na sua conta Wati.
2. No menu de navegação, clique em API, ou vá para: Conector → API → Criar Token de API
3. Na página Tokens de API, clique em Gerar novo token.
4. Insira um nome de token e selecione os escopos (permissões) necessários, como:
contacts:readcontacts:writemessagetemplate:read
5. (Opcional) Defina uma data de expiração para o token. Por segurança, recomenda-se girar os tokens a cada 6 meses.
6. Copie e armazene o token gerado de forma segura.
Observação:
A nova opção Criar novo token remove dependências no nível do usuário e permanecerá válida até que seja atualizada manualmente ou atinja a data de expiração.
Quando você usa a opção Criar novo token, o token é exibido apenas uma vez no momento da geração. Portanto, certifique-se de copiá-lo e armazená-lo com segurança.
Recursos adicionais
Documentação da API Wati – Referência detalhada para todas as APIs disponíveis
Documentação do Webhook – Aprenda como configurar e lidar com webhooks
Coleção Postman – Uma coleção pronta para uso para testar as APIs Wati
Essas APIs ajudam você a automatizar a comunicação do WhatsApp, simplificar os fluxos de trabalho de mensagens e gerenciar as interações com os clientes de forma mais eficiente. Consulte a documentação para obter detalhes de implementação e práticas recomendadas.
Perguntas Frequentes (FAQs)
APIs de Mensagens
1. Para que servem as APIs de mensagens Wati?
As APIs de mensagens Wati permitem que você envie e receba mensagens do WhatsApp programaticamente. Essas APIs habilitam ações como recuperar mensagens recebidas no seu número do WhatsApp, enviar mensagens ou arquivos dentro de uma sessão ativa do WhatsApp, enviar mensagens de modelo pré-aprovadas, enviar mensagens de modelo em massa e enviar mensagens interativas com botões ou listas selecionáveis.
2. Como você pode recuperar mensagens recebidas no seu número do WhatsApp usando as APIs Wati?
Você pode recuperar mensagens recebidas no seu número do WhatsApp usando a API Obter mensagens do número do WhatsApp. Esta API retorna mensagens que foram recebidas no número do WhatsApp conectado no Wati.
3. Quais tipos de mensagens podem ser enviadas usando as APIs de mensagens Wati?
As APIs de mensagens Wati permitem que você envie vários tipos de mensagens, incluindo mensagens de sessão durante uma sessão ativa do WhatsApp, anexos de arquivos dentro de uma sessão ativa, mensagens de modelo do WhatsApp pré-aprovadas, mensagens de modelo em massa, mensagens de botão interativas e mensagens de lista interativas.
APIs de gerenciamento de contatos
4. Para que servem as APIs de gerenciamento de contatos Wati?
As APIs de gerenciamento de contatos Wati permitem que você gerencie o banco de dados de contatos armazenado no Wati. Essas APIs permitem que você recupere a lista de contatos, crie novos contatos e atualize os atributos de contatos existentes.
5. Como você pode recuperar ou atualizar contatos usando as APIs Wati?
Você pode recuperar contatos usando a API Obter lista de contatos, criar um novo contato usando a API Adicionar contato e modificar os detalhes do contato usando a API Atualizar atributos de contato.
Mídia, autenticação e gerenciamento de conversas
6. Para que servem as APIs de mídia e autenticação no Wati?
As APIs de mídia e autenticação permitem que você recupere arquivos de mídia armazenados no Wati e mantenha o acesso seguro à API. Por exemplo, a API Obter mídia por nome de arquivo recupera arquivos de mídia armazenados, e a API Girar token atualiza o token de autenticação usado para acessar as APIs Wati.
7. Como você pode atribuir uma conversa do WhatsApp a um operador usando as APIs Wati?
Você pode atribuir uma conversa do WhatsApp a um operador específico usando a API Atribuir operador. Esta API encaminha a conversa para o operador selecionado para que ele possa gerenciar o chat.
Acesso e configuração da API
8. Onde você pode encontrar o endpoint da API e o token de acesso no Wati?
Você pode encontrar o endpoint da API e o token de acesso fazendo login na sua conta Wati e navegando até API no menu de navegação, ou indo para Conector → API → Criar Token de API.
9. Como você gera um novo token de API no Wati?
Para gerar um novo token de API, abra a página Tokens de API no Wati, clique em Gerar novo token, insira um nome de token, selecione os escopos necessários, como contacts:read, contacts:write ou messagetemplate:read, opcionalmente defina uma data de expiração e, em seguida, copie e armazene o token gerado de forma segura. Recomenda-se girar os tokens a cada seis meses por segurança.