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

> Conecte o número de um cliente com Embedded Signup hospedado.

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

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


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