Crie um cliente
POST /v1/customers aceita name e externalCustomerId opcional. O ID externo é único por conta; duplicados retornam 409.
Crie um link de conexão
UsePOST /v1/setup-links, opcionalmente com customerId, ou POST /v1/customers/{customerId}/setup-links.
Inclua allowedOrigins: de uma a oito origens HTTPS exatas, como https://app.example.com. Opcionais: successRedirectUrl, failureRedirectUrl e allowedConnectionTypes (dedicated, coexistence). Alinhe os redirecionamentos às origens permitidas.
O link abre /connect/{token}. É de uso único e expira em uma hora. Trate o link como sensível e compartilhe somente com o cliente pretendido.
Use webhooks de projeto para eventos de criação e desconexão de números; depois consulte GET /v1/phones.
Linhas pré-atribuídas
POST /v1/onboarding/connect exige telefone e WABA pré-atribuídos, um code do Embedded Signup e um pin de seis dígitos. Confira a etapa retornada antes de tentar novamente: uma etapa posterior pode falhar após salvar o token.
exchange e override-callback não são fluxos disponíveis para clientes. Receba eventos com webhooks de desenvolvedor, sem substituir o callback da Meta do gateway.