curl --request POST \
--url https://api.notifique.dev/v1/whatsapp/instances \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Soporte",
"mode": "UNOFFICIAL"
}
'{
"success": true,
"data": {
"instance": {
"id": "inst_abc",
"name": "Soporte",
"status": "PENDING",
"phoneNumber": null,
"mode": "UNOFFICIAL"
},
"connection": {
"status": "pending_qr",
"base64": "data:image/png;base64,...",
"code": "2@...",
"count": 1
}
}
}Crear instância WhatsApp
Conecta un número de WhatsApp a su workspace. Piense en esto como registrar el teléfono que enviará y recibirá mensajes por Notifique. Elija el ejemplo que encaje con su caso: - No oficial, QR en su pantalla — usted muestra el código en su interfaz y escanea en el celular.
- No oficial, código de emparejamiento — informa el número del celular; el usuario escribe el código en WhatsApp (Dispositivos vinculados → Vincular con número de teléfono), sin escanear QR.
- No oficial, enlace para el cliente — envía un enlace; el cliente escanea en su WhatsApp.
- Oficial, enlace para el cliente — envía un enlace; el cliente inicia sesión en Meta y vincula el número.
- Oficial, credenciales al momento — ya completó el registro Meta en el navegador y envía los datos en esta solicitud.
- Oficial, token Meta propio (BYOK) — usa token e IDs de su cuenta Meta directamente. Ámbito: whatsapp:instances:create.
curl --request POST \
--url https://api.notifique.dev/v1/whatsapp/instances \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"name": "Soporte",
"mode": "UNOFFICIAL"
}
'{
"success": true,
"data": {
"instance": {
"id": "inst_abc",
"name": "Soporte",
"status": "PENDING",
"phoneNumber": null,
"mode": "UNOFFICIAL"
},
"connection": {
"status": "pending_qr",
"base64": "data:image/png;base64,...",
"code": "2@...",
"count": 1
}
}
}Autorizaciones
API Key no header Authorization. Exemplo: Authorization: Bearer sk_live_xxxxx
Cuerpo
Nombre para identificar este número en el panel (ej.: Soporte, Ventas).
3 - 1024Opcional. Número internacional que espera conectar (ej.: 5511999999999). Si escanea otro chip, la API responde 409.
10 - 20Opcional (modo UNOFFICIAL). Si se informa, la instancia se crea y se solicita el código de emparejamiento en lugar del QR. El usuario escribe el código en el WhatsApp del celular.
10 - 20Genera un enlace para que otra persona termine la conexión. Use true cuando quien va a escanear o iniciar sesión en Meta no está en su pantalla. Omita o use false para recibir el QR en la respuesta y mostrarlo en su interfaz.
Código de Facebook al completar el registro Meta en el navegador (Embedded Signup). Obligatorio en la línea oficial, salvo con enlace compartible.
ID del número en Meta (línea oficial).
ID de la cuenta WhatsApp Business en Meta (línea oficial).
ID opcional del portafolio Business en Meta.
PIN opcional de registro del número en Cloud API de Meta.
Tipo de conexión. UNOFFICIAL (predeterminado): QR en el celular, ideal para pruebas. OFFICIAL: línea Meta (registro en navegador o enlace para el cliente). OFFICIAL_BYOK: línea Meta con token e IDs que ya posee. OFFICIAL_BSP: reservado.
UNOFFICIAL, OFFICIAL, OFFICIAL_BYOK, OFFICIAL_BSP Token de acceso permanente de Meta (modo BYOK — credenciales propias).
¿Esta página le ayudó?