> ## Documentation Index
> Fetch the complete documentation index at: https://docs.wtocrm.com/llms.txt
> Use this file to discover all available pages before exploring further.
# API WhatsApp para desenvolvedores: resposta rápida e conexão estável
> Conheça a WTO WA API via protocolo, com foco em baixa latência e menos desconexões. Conecte o WhatsApp por QR code ou código de pareamento e integre sua aplicação com API REST e webhooks.
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.
## Comece por três prioridades de desenvolvimento
| Sua dúvida | Foco da WTO WA API | O que avaliar na integração |
| - | - | - |
| A resposta vai atrasar meu fluxo? | Baixa latência e rapidez de resposta | Meça a duração da requisição separadamente da entrega da mensagem |
| A sessão vai continuar funcionando? | Conexões estáveis e menos desconexões | Consulte o estado e acompanhe eventos de conexão |
| Posso usar no produto que já tenho? | API REST e webhooks | Conecte mensagens ao seu backend, aos dados dos clientes e às regras de negócio |
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](/pt-BR/waapi/create-instance) e pela [conexão com QR code ou código de pareamento](/pt-BR/waapi/connect-instance). 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](/pt-BR/waapi/get-connection-state).
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
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](/pt-BR/waapi/send-text-message) e [configuração de webhook](/pt-BR/waapi/set-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:
```bash theme={null}
curl --request GET \
--url 'https://waapi.wtocrm.com/instance/connectionState/my-instance' \
--header 'apikey: YOUR_API_KEY'
```
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.
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.
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.