Passar para o conteúdo principal

Entendendo as APIs da Wati e seus limites de uso

Atualizado hoje

Resumo

Usando o CRM Wati, você tem acesso a um poderoso conjunto de APIs que ajudam você a se conectar com seus clientes no WhatsApp. Se você deseja enviar mensagens, gerenciar contatos ou integrar o Wati com seus próprios sistemas, este guia o orientará sobre quais APIs estão disponíveis, 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 Wati?

As APIs Wati são ferramentas que permitem que você interaja com o WhatsApp por meio de sua conta Wati. Elas são 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 com CRMs ou ferramentas de suporte e melhorar a comunicação com o cliente.

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

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

Cada plano 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 primeiro dia de cada mês.

  • Os limites não utilizados não são transferidos para o próximo mês.

Observação: 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 se aplicam apenas às APIs de desenvolvedor - como aquelas para enviar mensagens, gerenciar contatos e recuperar conversas.

Observação: 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 API de desenvolvedor com base em seu plano.

E se eu precisar de mais chamadas de API?

Se você estiver no Plano Business, você pode solicitar limites mais altos adicionando um complemento de cota de API.

Observação: Apenas clientes no plano Business podem solicitar limites de API mais altos. Se você estiver no plano Growth ou Pro, você precisará atualizar 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 através do widget disponível em nossa central de ajuda.

Diferença entre limites de uso de API e limites de taxa de API

Limites de taxa de API e limites de uso de API controlam diferentes aspectos de como as APIs podem ser usadas.

Limites de taxa de API restringem com que frequência você pode chamar um endpoint da API dentro de um período de tempo específico.

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

Abaixo estão alguns limites de taxa que você pode enfrentar, 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, o novo contato é adicionado automaticamente ao Wati quando a mensagem é enviada.

  • Recomendamos o uso de 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 que você inclua até 1000 contatos em uma única chamada de API.

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 em geral, enquanto os limites de taxa determinam a rapidez com que você pode enviar solicitações.

Em termos simples:

  • Limites de taxa controlam a velocidade das solicitações da API (solicitações por segundo ou por período 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 Wati

1. Para que são usadas as APIs Wati?

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

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

As APIs Wati podem ser usadas para automatizar fluxos de trabalho, integrar o Wati com CRM ou ferramentas 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 Wati são redefinidos?

Os limites de uso da API são redefinidos no primeiro dia de cada mês. Todas as chamadas de API não utilizadas expiram no final do mês e não são transferidas para o próximo mês.

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

Os limites de uso se aplicam apenas às APIs de desenvolvedor, como 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 de uso mensal.

Aumentando os limites da API

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

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

Limites de taxa de API

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

Os limites de taxa de API controlam com que frequência você pode chamar um endpoint de API dentro de um período de tempo específico, enquanto os limites de uso de 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 de API for excedido?

Se muitas solicitações de API forem enviadas em um curto período, o sistema bloqueará temporariamente solicitações adicionais e retornará um erro HTTP 429 (Muitas solicitações).

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?