Completar alta de WhatsApp Business mediante Embedded Signup v4

POST

/whatsapp-business/connections/embedded-signup/complete

curl --request POST \
  --url https://api.matiasimpulso.com/whatsapp-business/connections/embedded-signup/complete \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "code": "example", "businessAccountId": "107943950301460", "phoneNumberId": "109876543210987", "name": "Ventas Principal", "pin": "123456", "isCoexistence": false, "isDefault": false, "redirectUri": "example" }'

• Servidor de Producción (Cloud)
• Entorno de Desarrollo Local

Canjea el código de autorización OAuth de Meta por un token de negocio, registra el número en Cloud API (si aplica), cifra las credenciales y suscribe los webhooks.

Authorizations

• bearer

Request Body^required

Media type application/json

object

code

required

Código efímero de autorización devuelto por FB.login (response_type=code).

string

<= 2048 characters /^\S+$/

businessAccountId

ID de la cuenta de WhatsApp Business (waba_id) devuelto por WA_EMBEDDED_SIGNUP.

string

/^\d{1,64}$/

Example

107943950301460

phoneNumberId

ID del número de teléfono (phone_number_id) devuelto por WA_EMBEDDED_SIGNUP. Si se omite, se consulta el primer número de la cuenta WABA.

string

/^\d{5,64}$/

Example

109876543210987

name

Nombre amigable opcional para la conexión en Matias Impulso. Si se omite, se usa el nombre verificado en Meta.

string

<= 255 characters

Example

Ventas Principal

pin

PIN de verificación en dos pasos de 6 dígitos para registrar el número en Cloud API (omitir en modo Coexistencia).

string

/^\d{6}$/

Example

123456

isCoexistence

Indica si el alta corresponde a Coexistencia con la app WhatsApp Business móvil (omite POST /{phone_number_id}/register).

boolean

Example

false

isDefault

Define la conexión como predeterminada de la empresa.

boolean

Example

false

redirectUri

URI de redirección opcional si el código no provino del popup del SDK JS.

string

<= 512 characters

Responses

201

Conexión creada o actualizada mediante Embedded Signup

400

Código OAuth inválido o cuenta sin números asociados

409

Número en otra cuenta o límite de conexiones

502

No se pudo hablar con Meta

503

Faltan credenciales de la app Meta o clave de cifrado