waiaconnect

API de WhatsApp para desenvolvedores

O WAIA Connect é uma API REST sobre a API oficial do WhatsApp da Meta (Cloud API e Coexistence). Você envia um POST /v1/messages com a sua chave, nós o colocamos na fila e o entregamos à Meta em um ritmo seguro, e as mensagens que chegam vão para um webhook assinado. Provedor de tecnologia verificado pela Meta, com documentação pública, OpenAPI e exemplos em quatro linguagens.

O que a API resolve por você

  • Fila de saída com novas tentativas: o envio é confirmado com 202 e entregue à Meta respeitando o ritmo de cada número. Uma rejeição da Meta fica registrada no status da mensagem com um código estável.
  • Idempotência: o cabeçalho Idempotency-Key evita enviar duas vezes a mesma mensagem se você tentar de novo.
  • Webhooks assinados com HMAC sobre data e corpo (proteção contra reenvios), e um cabeçalho estático opcional para ferramentas sem código como o n8n.
  • Modelos: criá-los, sincronizá-los e validá-los antes de enviá-los à Meta, com o motivo e como corrigir se algo for ser rejeitado.
  • Mídia: enviar imagem, documento, áudio e vídeo por link, e baixar a mídia que chega por um proxy.
  • Erros da Meta traduzidos para um catálogo de códigos estáveis, com o que fazer em cada caso.

Como fica

Um envio é uma requisição HTTP com a sua chave de API. O número sai do identificador de conexão (conn_…) que GET /v1/connections devolve.

Exemplos prontos para copiar em cURL, Node.js, PHP e Python: Enviar uma mensagem. O contrato completo: OpenAPI.

O que ela não faz

  • Não é uma caixa de entrada de conversas para atender com uma equipe: para isso existe o WAIA, o nosso produto pronto para usar.
  • Não guarda arquivos: para enviar um arquivo seu, você o hospeda e envia o link.
  • Não tira você das regras da Meta: a janela de 24 horas, os modelos aprovados e os limites de envio continuam valendo. Nós os explicamos em Antes de conectar.

Quanto custa

Tarifa fixa por número conectado, sem teto de mensagens. Você começa com 14 dias de teste; o plano menor é o Starter (US$ 12 por mês).

  • Starter — US$ 12 por mês, 1 número
  • Studio — US$ 25 por mês, 5 números
  • Agencia — US$ 45 por mês, 12 números
  • Escala — US$ 99 por mês, 30 números, e US$ 3 por número extra

A Meta cobra à parte as mensagens dela, no seu cartão; não acrescentamos nenhuma taxa. Comparação com quem acrescenta: WAIA Connect vs Twilio.

Perguntas frequentes

Usa a API oficial da Meta?

Sim. O WAIA Connect é um provedor de tecnologia verificado pela Meta e opera a Cloud API e a convivência (Coexistence). Não usa bibliotecas não oficiais que simulam o WhatsApp Web.

Como recebo as mensagens que chegam?

Você registra uma URL https e elas chegam por POST, assinadas com HMAC. O guia de verificação da assinatura tem exemplos em quatro linguagens.

O que acontece se eu enviar a mesma requisição duas vezes?

Com o mesmo Idempotency-Key a mensagem é enviada uma única vez e a segunda resposta devolve o mesmo identificador.

Existe limite de mensagens por mês?

No WAIA Connect, não: o plano é pago por número conectado. A Meta tem limites próprios para iniciar conversas com modelos, que dependem da sua conta da Meta.

A documentação foi pensada para ser lida com uma IA?

Sim: cada módulo também está em Markdown, há um llms.txt na raiz do site e o contrato completo está em OpenAPI.

Continue lendo

Conecte o seu primeiro número hoje

Provedor de tecnologia verificado pela Meta. Coexistence em um clique.

Começar