O que você pode e o que não pode fazer com a API do Whaticket

A API do Whaticket conecta a plataforma a outros sistemas, como CRMs, ferramentas de automação e aplicativos internos. Com ela, você automatiza ações como criar contatos, enviar mensagens a partir de um evento e organizar chats. Para usar a API, é preciso conhecimento técnico de programação ou o apoio de um profissional de TI.

O que a API faz

Cria e atualiza contatos: envia nome, telefone, e-mail, campos personalizados e etiquetas para o Whaticket.
Envia mensagens automáticas: dispara uma mensagem quando algo acontece em outro sistema, como um novo lead no CRM.
Envia mensagens para vários contatos: a mesma mensagem para todos ou uma mensagem personalizada por contato, em até 999 mensagens por requisição.
Envia arquivos: imagens, PDFs e outros tipos de arquivo.
Envia templates: em conexões de API oficial, com variáveis no cabeçalho e no corpo.
Atribui chats: define o atendente, o departamento e o status do chat criado, e pode manter o chat com o atendente até uma data.
Trabalha com chats existentes: lista, responde, resolve, adia, transfere, atribui e troca o departamento de um chat.
Consulta dados da conta: conexões, usuários, departamentos, respostas rápidas, mensagens agendadas e relatórios de conversas.
Gerencia a base de conhecimento da Wäbot: cria, edita e exclui artigos e trata as lacunas.

Cada token usa as permissões do perfil escolhido na criação. A rota só funciona se o perfil tiver a permissão que ela exige.

O que a API não faz

Não envia alterações para outros sistemas: se você edita um contato no Whaticket, a API não avisa o seu CRM. A integração parte do seu sistema para o Whaticket. Para avisar outro sistema durante o atendimento, use a ação Chamar webhook em uma opção de chatbot, em Departamentos & Chatbots.
Não faz nada além do que está na documentação: ações que não aparecem na aba Documentação, em Integrações, não estão disponíveis.
Não inclui implementação pelo suporte: a equipe de suporte da Whaticket tira dúvidas pontuais sobre o funcionamento, mas não programa nem implementa a integração.

Quanto custa usar a API

Só as mensagens enviadas por conexões WhatsApp QR Code consomem créditos de campanha. Em conexões WhatsApp API Cloud e WhatsApp API Coexistência, a Meta cobra cada template enviado diretamente da sua conta.

Todas as outras rotas, como criar contatos, consultar conexões ou reiniciar uma conexão QR Code, não consomem créditos.
Durante o período de teste, os envios por qualquer conexão consomem créditos.
Quando os créditos acabam, a campanha da API fica suspensa e as mensagens restantes só são enviadas depois que você adicionar créditos.

Pacotes de créditos de campanha disponíveis:

1.000 créditos: R$ 140 ou US$ 25
2.000 créditos: R$ 210 ou US$ 38
5.000 créditos: R$ 410 ou US$ 75
7.500 créditos: R$ 580 ou US$ 105

Para comprar, abra Configurações, vá na aba Assinatura e clique em Adicionar créditos de campanha. Seu perfil precisa da permissão Comprar créditos. Os créditos entram na hora, em uma cobrança única, e não são reembolsados se não forem usados.

Antes de usar a API

Tenha conhecimento técnico ou conte com um desenvolvedor especialista em integrações.
Leia a documentação da API em Integrações > Documentação antes de começar.
Crie um token em Integrações > Tokens com um perfil que tenha só as permissões necessárias.

Perguntas frequentes

Existe limite de requisições?
Sim. Cada rota aceita até 600 requisições por minuto.

Posso conectar um agente de IA, como Claude ou ChatGPT?
Sim. Em Integrações, a aba Apps conectados mostra a URL do servidor MCP para conectar agentes de IA com as permissões de um perfil.