Documentación de integración

Base URL

https://wapiflex.link

Esta URL se toma de la Web pública configurada en administración. Si no existe, se usa la URL pública del entorno.

Autenticación

Envía las credenciales en headers HTTP:

• x-public-key: public key de la sesión.
• x-secret-key: secret key generada para esa public key.

Probar conexión

Endpoint: POST https://wapiflex.link/api/public/test

curl -X POST https://wapiflex.link/api/public/test \ -H "Content-Type: application/json" \ -H "x-public-key: pk_xxx" \ -H "x-secret-key: sk_xxx"

Enviar mensaje

Endpoint: POST https://wapiflex.link/api/public/messages/send

curl -X POST https://wapiflex.link/api/public/messages/send \ -H "Content-Type: application/json" \ -H "x-public-key: pk_xxx" \ -H "x-secret-key: sk_xxx" \ -d '{ "to": "51999999999", "message": "Hola desde API externa", "linkPreview": false }'

Límites operativos

• Solicitudes por minuto: configurable por API Key.
• Mensajes por día: configurable por API Key.
• Espera mínima entre mensajes: configurable por API Key.
• La suscripción del usuario también puede aplicar límites adicionales de mensajes y funciones.
• Para usuarios, el destinatario debe tener consentimiento registrado.

Respuestas comunes

{ "ok": true, "authenticated": true, "connected": true, "message": "Conexión API validada correctamente." }

• 401: credenciales inválidas o API Key inactiva.
• 402: suscripción o límite diario no disponible.
• 403: destinatario sin consentimiento registrado.
• 409: sesión asociada no conectada.
• 429: límite por minuto o espera mínima activa.
• 422: payload inválido o error de envío.