Skip to main content
POST
Create a cloud_api connection manually
Cria uma conexão WhatsApp API Oficial a partir de credenciais geradas no Meta Business Manager: o id da WhatsApp Business Account (wabaId), o id do número (phoneNumberId) e um accessToken. O backend valida o par (número, token) na Graph API, tenta assinar os webhooks do app (best-effort) e então provisiona a conexão e sincroniza a cobrança do plano Scale.
  • webhookModenormalized (eventos canônicos D-API) ou meta_passthrough (payloads crus da Meta). Padrão: normalized.
  • data.webhookSubscribed — quando false, mostre ao usuário as instruções para assinar o webhook manualmente no painel da Meta.
Requer uma assinatura ativa. Sem assinatura, a resposta é 402 com code: "TRIAL_REQUIRED" — direcione o usuário ao checkout do plano Scale.
Para o fluxo guiado via Embedded Signup (SDK), use o assistente de integração em vez do cadastro manual de token.

Authorizations

Authorization
string
header
required

API Key para autenticação. Formato: <API_KEY>

Body

wabaId
string
required
Minimum string length: 1
phoneNumberId
string
required
Minimum string length: 1
accessToken
string
required
Minimum string length: 1
businessId
string
webhookMode
Allowed value: "normalized"

Response

Resposta bem-sucedida

success
boolean
required
data
any
error
string
code
string