Skip to main content
Você criou um fluxo de notificações de pedidos, um bot de atendimento ou um módulo de mensagens para seu CRM. Agora, precisa manter o canal do WhatsApp funcionando. Respostas lentas e desconexões que passam despercebidas podem consumir seu tempo com investigação de sessões, novas tentativas e ajuda aos clientes para entrar novamente. A WTO WA API atende desenvolvedores que integram o WhatsApp aos próprios produtos. A conexão via protocolo tem como prioridades baixa latência, estabilidade e redução de desconexões. Com endpoints REST, consulta de estado e webhooks, você conecta o canal de mensagens à lógica do seu negócio.
WTO WA API via protocolo: respostas rápidas, conexões estáveis e menos desconexões

A WTO WA API prioriza respostas rápidas, conexões estáveis e menos desconexões nas suas integrações.

​
Comece por três prioridades de desenvolvimento

Em um SaaS, CRM ou ferramenta de automação, você precisa de um fluxo de mensagens que continue operando e cujo estado possa acompanhar. Um único envio bem-sucedido é apenas o começo.

​
Acesso via protocolo: conecte a conta e use a API

O modo de conexão da WTO WA API descrito aqui usa uma sessão de dispositivo conectado do WhatsApp. Você entra com QR code ou código de pareamento por número de telefone e utiliza a instância para chamar os endpoints. Esse processo difere da integração com a WhatsApp Business Cloud API. Escolha o modo de conexão adequado ao seu projeto. Sua aplicação mantém o controle da interface, das regras de negócio e dos dados dos clientes, enquanto a API executa as operações do WhatsApp. Você pode usar a linguagem do seu backend para fazer requisições HTTP, processar respostas e receber eventos. Comece pela criação de uma instância e pela conexão com QR code ou código de pareamento. Use uma conta de teste no primeiro fluxo.

​
Rapidez de resposta: acompanhe o ritmo do seu negócio

Uma nova consulta, uma atualização de pedido ou uma resposta do atendimento pode disparar uma requisição de mensagem. O tempo de resposta da API influencia quando sua aplicação atualiza a interface, registra o resultado ou agenda a próxima etapa. A baixa latência é uma prioridade da WTO WA API. Meça a duração das requisições nas condições de rede e concorrência do seu projeto para avaliar se o desempenho atende ao fluxo. Separe tempo de resposta da API de tempo de entrega ao destinatário. Uma resposta HTTP rápida não confirma a entrega. A rede e o estado da conta do destinatário também influenciam a experiência. Se uma requisição exceder o tempo limite, verifique o resultado antes de tentar novamente para evitar mensagens duplicadas.

​
Conexão estável: reduza as interrupções do fluxo

Menos desconexões significam menos investigações sobre por que uma integração parou de funcionar e menos interrupções causadas por novos logins. A WTO WA API prioriza a estabilidade e disponibiliza informações de estado para sua aplicação. Consulte a conexão ou assine o evento CONNECTION_UPDATE por webhook para atualizar indicadores, alertas ou a lógica de envio. O guia de conexão utiliza estes estados:
  • open: a conexão foi estabelecida e você pode continuar o fluxo de envio.
  • connecting: a conexão está sendo estabelecida; aguarde e consulte novamente.
  • close: a sessão está desconectada e precisa ser verificada.
Receber um QR code ou código de pareamento não significa que o login terminou. Confirme que instance.state está em open antes de enviar mensagens. Consulte a referência de estado da conexão. A rede, o estado da conta e mudanças na plataforma ainda podem afetar a estabilidade. Observe a frequência, a duração e a recuperação das desconexões no seu próprio uso para avaliar a experiência.

​
API REST e webhooks: leve o WhatsApp para seu produto

Ilustração conceitual da conexão da conta, das requisições e respostas da API e dos eventos de webhook enviados à aplicação

Fluxo conceitual: conecte a conta, faça chamadas à API e receba eventos de webhook na sua aplicação.

Use os endpoints REST para iniciar operações e os webhooks para receber eventos na aplicação. Assim, você pode criar fluxos de mensagens ligados aos seus dados de negócio:
  • Notificações de SaaS: Dispare uma notificação em uma etapa relevante para o cliente e mostre o resultado do processamento no produto.
  • Integração com CRM: Associe mensagens a contatos, responsáveis e ações de acompanhamento.
  • Atendimento e aplicações de IA: Encaminhe eventos de mensagens recebidas ao seu serviço e use o endpoint de envio para responder.
Esses são cenários que você pode implementar na sua aplicação. Comece com envio de mensagens de texto e configuração de webhook. Depois, expanda para outros tipos de mensagem.

​
Implemente um fluxo completo primeiro

  1. Crie uma instância. Use credenciais autorizadas para ela e mantenha-as no backend.
  2. Conecte a conta. Escolha QR code ou código de pareamento e siga as instruções de vinculação do dispositivo.
  3. Confirme o estado. Aguarde open antes de enviar.
  4. Envie uma mensagem de teste. Siga a documentação do endpoint e use seu próprio número de teste. Confira a resposta da API e o recebimento da mensagem.
  5. Receba eventos. Configure um webhook para os eventos de mensagens e mudanças de conexão necessários à aplicação.
Após o login, consulte a conexão com esta requisição somente de leitura. Substitua my-instance pelo nome da instância e YOUR_API_KEY por uma credencial autorizada:
Conclua o fluxo de conexão, consulta, envio e recebimento de eventos antes de avaliar a latência e as sessões com a carga real. Você passa a desenvolver sobre um fluxo verificado, sem depender de testes manuais constantes para saber se a conexão está ativa.

Comece a integrar a WTO WA API

Conecte sua primeira instância do WhatsApp por QR code ou código de pareamento e crie um canal de mensagens para seu SaaS, CRM ou aplicação de automação.