> ## Documentation Index
> Fetch the complete documentation index at: https://docs.watahub.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar números de clientes

> Conecta el número de un cliente con Embedded Signup alojado.

## 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

Usa `POST /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](https://docs.watahub.dev/es/webhooks.md) 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.