Crea un cliente
POST /v1/customers acepta name y externalCustomerId opcional. El ID externo es único por cuenta; los duplicados devuelven 409.
Crea un enlace de conexión
UsaPOST /v1/setup-links, opcionalmente con customerId, o POST /v1/customers/{customerId}/setup-links.
Incluye allowedOrigins: de uno a ocho orígenes HTTPS exactos, como https://app.example.com. Los opcionales incluyen successRedirectUrl, failureRedirectUrl y allowedConnectionTypes (dedicated, coexistence). Alinea las redirecciones con los orígenes permitidos.
El enlace abre /connect/{token}. Es de un solo uso y caduca en una hora. Trátalo como información sensible y compártelo solo con el cliente correspondiente.
Usa webhooks de proyecto para eventos de creación y desconexión de números; luego consulta GET /v1/phones.
Líneas preasignadas
POST /v1/onboarding/connect requiere teléfono y WABA preasignados, un code de Embedded Signup y un pin de seis dígitos. Revisa el paso devuelto antes de reintentar: un paso posterior puede fallar tras guardar el token.
exchange y override-callback no son flujos disponibles para clientes. Recibe eventos con webhooks de desarrollador, sin sustituir el callback de Meta del gateway.