Passar para o conteúdo principal

Wati's API suporte para múltiplos números do WhatsApp

Atualizado há mais de 2 semanas

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

Respondeu à sua pergunta?