Judot Documentação Falar no WhatsApp

API oficial do WhatsApp: o que é e por que usar

A API oficial do WhatsApp é a WhatsApp Cloud API, o jeito autorizado pela Meta de ligar um número a sistemas, CRMs e agentes de IA. O Judot é Tech Provider da Meta, com acesso avançado aprovado em 3 de outubro de 2026, e conecta o seu número pelo cadastro oficial da Meta, sem QR code de WhatsApp Web. Pela API, você responde livremente até 24 horas depois da última mensagem do cliente; fora disso, só com template aprovado pela Meta.

Atualizado em

O que é a API oficial do WhatsApp?

A WhatsApp Cloud API é o serviço da própria Meta para empresas mandarem e receberem mensagens no WhatsApp por meio de sistemas. A Meta hospeda tudo: o número fica registrado na plataforma dela, as mensagens recebidas chegam ao seu sistema por webhook (um aviso automático pela internet) e as respostas saem por uma chamada à API.

Na prática, isso permite que uma equipe inteira atenda o mesmo número pelo computador, que um agente de IA responda de madrugada e que o seu CRM saiba quando cada mensagem foi entregue e lida. A Meta cobra por mensagem enviada, por categoria, conforme a tabela oficial de preços da Meta. Veja quanto custa somando tudo em planos e preços do Judot.

O que é um Tech Provider da Meta?

Tech Provider é a empresa de tecnologia autorizada pela Meta a conectar números de outras empresas à API oficial, pelo cadastro incorporado (Embedded Signup): uma janela oficial da Meta em que o dono do número faz login no Facebook e autoriza a conexão, sem passar senha para ninguém. Para isso, a empresa precisa ter o negócio verificado pela Meta e passar pela análise do app (App Review), como descreve o guia da Meta para Tech Providers.

  • O Judot é um produto da Castilho IA Tecnologia Ltda, empresa verificada pela Meta.
  • O App Review foi aprovado em 3 de outubro de 2026, com acesso avançado às permissões de mensagens e de gestão de contas do WhatsApp.
  • A conta do WhatsApp continua no nome da sua empresa. Você paga as mensagens direto à Meta, no seu cartão, e pode desconectar quando quiser.

Qual a diferença entre a API oficial e as soluções por QR code?

Existem ferramentas que conectam o WhatsApp lendo o QR code do WhatsApp Web e automatizando o aplicativo por fora. Elas não são autorizadas pela Meta. Os Termos de Serviço do WhatsApp proíbem acessar o serviço por meios automatizados ou não autorizados.

API oficial (Cloud API)Conexão por QR code
Como conectaCadastro oficial da Meta, com login no FacebookLeitura do QR code do WhatsApp Web
Autorizada pela MetaSimNão
Regras de envioJanela de 24h, templates aprovados e limite diário de novos contatosSem regras formais, o que facilita abuso e denúncias
Status de entrega e leituraEnviados pela Meta por webhookDependem de automação do aplicativo
Custo das mensagensCobrado pela Meta, por categoriaSem cobrança da Meta, mas fora das regras dela

A API oficial reduz o risco de bloqueio, mas não o elimina: a Meta pode limitar ou bloquear qualquer número que viole as políticas dela, por exemplo com muitas denúncias de spam.

Quer comparar ferramentas lado a lado? Veja os comparativos de soluções de WhatsApp.

O que é a janela de 24 horas do WhatsApp?

É a regra principal da API oficial. Cada vez que o cliente manda uma mensagem, abre-se uma janela de 24 horas em que você responde livremente: texto, foto, áudio, documento, botões. Passadas as 24 horas desde a última mensagem dele, a empresa só pode puxar a conversa com um template aprovado pela Meta.

O Judot confere a janela antes de enviar. Se ela já fechou, o envio é barrado com o aviso JANELA_EXPIRADA, sem gastar uma chamada na Meta, e o painel sugere usar um template. Em coexistência, as mensagens que você manda pelo app do celular não passam pela API e não seguem essa regra.

O que são templates do WhatsApp?

Template é um modelo de mensagem que a Meta analisa antes de você poder usar. Ele pode ter cabeçalho, corpo com variáveis (como o nome do cliente), rodapé e botões. Cada template tem uma categoria:

  • Marketing: promoções, novidades, convites.
  • Utilidade: confirmação de pedido, lembrete de consulta, aviso de entrega.
  • Autenticação: códigos de verificação.

A Meta pode mudar a categoria que você escolheu, e o preço segue a categoria final. No Judot você cria templates pelo painel, pela API ou pedindo à sua IA, e acompanha o status (em análise, aprovado, reprovado com o motivo, pausado). Detalhes em como criar templates no Judot.

O que é o messaging limit?

É o número máximo de contatos diferentes com quem o seu número pode iniciar conversa em 24 horas. Responder quem falou com você não conta. O limite sobe em degraus (250, 1 mil, 10 mil, 100 mil e ilimitado) conforme o volume e a qualidade dos envios.

A qualidade é medida pela Meta em verde, amarelo ou vermelho, a partir de bloqueios e denúncias. Qualidade vermelha derruba o limite. O painel do Judot mostra a qualidade e o limite de cada número, e contatos que pediram para não receber mensagens são bloqueados no envio de template (aviso OPT_OUT).

Por que a API oficial importa para a sua empresa?

  • Menos risco para o número: você segue as regras da Meta em vez de depender de uma brecha.
  • Equipe e IA no mesmo número: várias pessoas e agentes de IA atendem pela mesma caixa de entrada.
  • Você mantém o celular: com a coexistência, o app WhatsApp Business continua funcionando.
  • Dados confiáveis: entrega, leitura e falhas chegam da própria Meta.
  • Integração aberta: API REST, webhooks e conexão com o Claude e outras IAs.

Pronto para começar? Veja como conectar o seu número na API oficial.

Perguntas frequentes

A API oficial do WhatsApp é paga?

Sim. A Meta cobra por mensagem enviada, conforme a categoria (marketing, utilidade, autenticação e serviço) e o país do contato, direto no cartão que você cadastra na Meta. A assinatura do Judot é cobrada à parte, por número conectado.

Preciso trocar de número para usar a API oficial?

Não. Com a coexistência, você conecta o número que já usa no app WhatsApp Business e ele continua funcionando no celular.

A API oficial acaba com o risco de banimento?

Não acaba, mas reduz. A conexão é autorizada pela Meta, sem QR code de WhatsApp Web. A Meta ainda pode limitar ou bloquear números que violam as políticas dela, por exemplo com muitas denúncias de spam.

O que acontece se eu tentar responder depois de 24 horas?

Pela API, só é possível enviar um template aprovado pela Meta. O Judot barra o envio de texto livre com o aviso JANELA_EXPIRADA antes de chamar a Meta.

Quanto tempo a Meta leva para aprovar um template?

Depende da Meta. O template entra como em análise e o Judot atualiza o status sozinho quando a Meta aprova, reprova ou pausa, mostrando o motivo da reprovação.

O que significa o Judot ser Tech Provider?

Significa que a Meta verificou a empresa e aprovou o app para conectar números de outras empresas à API oficial pelo cadastro incorporado. A aprovação saiu em 3 de outubro de 2026.

Quer começar com o Judot?

R$ 59,90 por mês por número, com 7 dias de garantia e reembolso integral. Cancela quando quiser, direto no painel.