Resumo
Se você está usando o recurso Vários Números do WhatsApp do Wati, este guia explica como usar a API do Wati em diferentes números conectados.
Instruções
Usar múltiplos números do WhatsApp na sua conta do Wati permite enviar e receber mensagens de diferentes números. Para garantir que suas chamadas de API passem pelo número correto, você precisa incluir uma chave extra no payload ou na URL, dependendo da API que está usando.
Abaxio estão as APIs que suportam múltiplos números atualmente e como usá-las.
1. API para enviar mensagem de modelo
Endpoint:POST /{tenantId}/api/v1/sendTemplateMessage
Campos obrigatórios:
ID do Inquilino
Número do WhatsApp
channelNumber (no payload): O número de telefone que você deseja enviar a mensagem.
Por exemplo, se você quiser que a mensagem seja enviada a partir do seu número padrão, defina channelNumber
como esse número de telefone padrão.
2. API para atualizar status do chat
Endpoint:POST /{tenantId}/api/v1/updateChatStatus
Campos obrigatórios:
ID do Inquilino
channelPhoneNumber (no payload): Defina isso como o número cujo status do chat você deseja atualizar.
O status do chat será atualizado para o Número de Telefone enviado como valor para "channelPhoneNumber".
3. API para obter mensagens por número do WhatsApp
Endpoint:GET /{tenantId}/api/v1/getMessages/{whatsappNumber}
Aqui, como mostrado abaixo, os parâmetros de consulta de Número do WhatsApp e ID do Inquilino são obrigatórios, e para obter a mensagem de qual número conectado, é necessário especificá-la como um parâmetro de consulta
Por exemplo, para buscar mensagens do seu número padrão, forneça esse número como valor para channelPhoneNumber
.
4. Enviar mensagem para sessão aberta
Endpoint: Post /{tenantId}/api/v1/sendSessionMessage/{whatsappNumber}
Como mostrado abaixo, o parâmetro "ID do Inquilino", "Número do WhatsApp" e "Texto da Mensagem" são obrigatórios, e no payload é necessário especificar o "channelPhoneNumber".
Por exemplo: Para enviar uma mensagem de sessão do Número Padrão. Especifique o número padrão como valor para "channelPhoneNumber" no payload
5. Outras APIs que funcionam sem especificar o número
As seguintes APIs não exigem um número de telefone específico, pois os dados de contato são compartilhados em todos os números conectados:
Adicionar Contato:
POST /{tenantId}/api/v1/addContact/{whatsappNumber}
Atualizar Atributos de Contato:
POST /{tenantId}/api/v1/updateContactAttributes/{whatsappNumber}
Atualizar Lista de Atributos de Contato:
Obter Lista de Contatos:
Nota: Você pode encontrar seu Token de Acesso e detalhes do endpoint da API acessando a página Docs da API no seu ambiente Wati.
APIs do Wati e seu suporte para Múltiplos Números do WhatsApp
Nome da API | Disponível |
Enviar mensagem de modelo | Sim |
Enviar mensagens de modelo | Sim |
Obter Mensagens pelo Número do WhatsApp | Sim |
Obter Lista de Contatos | Sim |
Atualizar Atributos de Contato | Sim |
Atualizar Lista de Atributos de Contato | Sim |
Adicionar Contato | Sim |
Enviar Mensagem para Sessão Aberta | Sim |
Atualizar Status do Chat | Sim |