Passar para o conteúdo principal

Entendendo as APIs da Wati e seus limites de uso

Resumo

Ao usar o Wati CRM, você tem acesso a um poderoso conjunto de APIs que ajudam a se conectar com seus clientes no WhatsApp. Seja para enviar mensagens, gerenciar contatos ou integrar o Wati aos seus próprios sistemas, este guia mostrará quais APIs estão disponíveis, os limites de uso por plano, quando os limites são redefinidos e o que fazer se precisar de mais.

Instruções

O que são as APIs do Wati?

As APIs do Wati são ferramentas que permitem interagir com o WhatsApp por meio da sua conta Wati. Elas foram projetadas para ajudar você a:

  • Recuperar e enviar mensagens

  • Gerenciar listas de contatos de clientes

  • Conectar-se com seus próprios aplicativos e sistemas

Você pode usar essas APIs para automatizar fluxos de trabalho, integrar-se a CRMs ou ferramentas de suporte e melhorar a comunicação com o cliente.

Dica: Para testar e explorar essas APIs, recomendamos conferir a documentação da API do Wati.

Quais são os limites de uso da API em cada plano?

Cada plano do Wati vem com uma cota mensal diferente de chamadas de API:

  • Plano Growth: 10.000 chamadas de API

  • Plano Pro: 200.000 chamadas de API

  • Plano Business: 20 milhões de chamadas de API

Esses limites ajudam a garantir o uso justo e o desempenho consistente para todos os usuários.

Quando os limites da API são redefinidos?

  • Os limites de uso da API são redefinidos no dia 1º de cada mês.

  • Limites não utilizados não são acumulados para o mês seguinte.

Nota: Se você não usar sua cota total, as chamadas restantes expirarão no final do mês.

O que está incluído no acesso à API?

Os limites de uso mencionados acima aplicam-se apenas às APIs de desenvolvedor - como aquelas para enviar mensagens, gerenciar contatos e recuperar conversas.

Nota: Não há limites de uso nas APIs de pagamento neste momento.

Isso significa que você pode usar livremente as APIs relacionadas a pagamentos sem se preocupar com limites mensais, enquanto ainda gerencia o uso da sua API de desenvolvedor com base no seu plano.

E se eu precisar de mais chamadas de API?

Se você estiver no Plano Business, poderá solicitar limites maiores adicionando um complemento de cota de API.

Nota: Apenas clientes no Plano Business são elegíveis para solicitar limites de API mais altos. Se você estiver no plano Growth ou Pro, precisará fazer upgrade para o plano Business para aumentar seus limites de API.

Para solicitar um complemento ou discutir suas necessidades, entre em contato com nossa equipe de suporte.

Diferença entre limites de uso da API e limites de taxa (rate limits) da API

Os limites de taxa (rate limits) da API e os limites de uso da API controlam diferentes aspectos de como as APIs podem ser usadas.

Os limites de taxa da API restringem a frequência com que você pode chamar um endpoint de API dentro de uma janela de tempo específica.

Se você enviar muitas solicitações em um curto período, o sistema bloqueará temporariamente solicitações adicionais e retornará um erro HTTP 429 (Too Many Requests).

Abaixo estão alguns limites de taxa que você pode encontrar, dependendo do seu caso de uso:

Endpoint

Plano Growth

Plano Pro

Plano Business

/addContact, /getContacts

10 / 10 seg

10 / 10 seg

10 / 10 seg

/getMessages

10 / 10 seg

10 / 10 seg

10 / 10 seg

/sendTemplateMessage

30 / 10 seg

60 / 10 seg

100 / 10 seg

/sendTemplateMessages

30 / 10 seg

60 / 10 seg

100 / 10 seg

Notas:

  • Você não precisa adicionar contatos antes de enviar sua primeira mensagem. Se o contato não existir, ele será automaticamente adicionado ao Wati quando a mensagem for enviada.

  • Recomendamos usar webhooks em vez do endpoint /getMessages para receber mensagens recebidas de forma mais eficiente.

  • Se você estiver enviando a mesma mensagem de modelo para vários contatos, é recomendável usar o endpoint /sendTemplateMessages em vez de /sendTemplateMessage.

  • O endpoint /sendTemplateMessages permite incluir até 1000 contatos em uma única chamada de API.

Os limites de uso da API, por outro lado, referem-se ao número total de chamadas de API com base no seu plano de assinatura. Os limites de uso determinam o quanto você pode usar a API no geral, enquanto os limites de taxa determinam quão rápido você pode enviar solicitações.

Em termos simples:

  • Limites de taxa (rate limits) controlam a velocidade das solicitações de API (solicitações por segundo ou por janela de tempo).

  • Limites de uso controlam o volume total de uso da API permitido em seu plano.

Perguntas Frequentes (FAQs)

Visão Geral das APIs do Wati

1. Para que servem as APIs do Wati?

As APIs do Wati permitem interagir com o WhatsApp por meio da sua conta Wati. Essas APIs podem ser usadas para recuperar e enviar mensagens, gerenciar listas de contatos de clientes e conectar o Wati aos seus próprios aplicativos ou sistemas.

2. Quais tarefas podem ser automatizadas usando as APIs do Wati?

As APIs do Wati podem ser usadas para automatizar fluxos de trabalho, integrar o Wati a ferramentas de CRM ou de suporte, enviar e recuperar mensagens e gerenciar contatos de clientes.

Limites de Uso da API

3. Quais são os limites mensais de uso da API para cada plano Wati?

Os limites mensais de uso da API dependem do plano Wati:

  • Plano Growth: 10.000 chamadas de API por mês

  • Plano Pro: 200.000 chamadas de API por mês

  • Plano Business: 20 milhões de chamadas de API por mês

4. Quando os limites de uso da API do Wati são redefinidos?

Os limites de uso da API são redefinidos no dia 1º de cada mês. Quaisquer chamadas de API não utilizadas expiram no final do mês e não são acumuladas para o mês seguinte.

5. Quais APIs estão incluídas nos limites de uso da API do Wati?

Os limites de uso aplicam-se apenas às APIs de desenvolvedor, como as APIs usadas para enviar mensagens, gerenciar contatos e recuperar conversas.

6. Existem limites de uso para APIs de pagamento no Wati?

Não. Atualmente não há limites de uso para APIs relacionadas a pagamentos, portanto, as APIs de pagamento podem ser usadas sem um limite mensal de uso.

Aumentando os Limites da API

7. Como posso solicitar mais chamadas de API no Wati?

Clientes no Plano Business podem solicitar limites maiores de API adicionando um complemento de cota de API. Clientes nos planos Growth ou Pro devem fazer upgrade para o Plano Business antes de solicitar limites de API mais altos.

Limites de Taxa da API

8. Qual é a diferença entre limites de taxa da API e limites de uso da API?

Os limites de taxa da API controlam a frequência com que você pode chamar um endpoint de API dentro de uma janela de tempo específica, enquanto os limites de uso da API controlam o número total de chamadas de API permitidas em seu plano de assinatura. Os limites de taxa gerenciam a velocidade das solicitações, enquanto os limites de uso gerenciam o volume geral de uso da API.

9. O que acontece se um limite de taxa da API for excedido?

Se muitas solicitações de API forem enviadas em um curto período, o sistema bloqueia temporariamente solicitações adicionais e retorna um erro HTTP 429 (Too Many Requests).

10. Quais são alguns exemplos de limites de taxa de API no Wati?

Exemplos de limites de taxa de API incluem:

  • /addContact e /getContacts: 10 solicitações a cada 10 segundos em todos os planos

  • /getMessages: 10 solicitações a cada 10 segundos em todos os planos

  • /sendTemplateMessage: 30 solicitações a cada 10 segundos para o Plano Growth, 60 solicitações a cada 10 segundos para o Plano Pro e 100 solicitações a cada 10 segundos para o Plano Business

  • /sendTemplateMessages: 30 solicitações a cada 10 segundos para o Plano Growth, 60 solicitações a cada 10 segundos para o Plano Pro e 100 solicitações a cada 10 segundos para o Plano Business

Respondeu à sua pergunta?