API Gateway¶

Endpoint público para enviar mensajes desde cualquier sistema (admin ISP propio, integración custom, app móvil, etc.).

Endpoint¶

POST https://gw.hybschat.com/mw

Autenticación¶

Por appkey como parámetro de query string. Cada cliente HybsChat tiene la suya única, visible en su panel.

?appkey=K_ISP_<empresa>_<random>

Parámetros¶

Campo	Tipo	Obligatorio	Descripción
`to`	string	sí	Teléfono destino (con o sin `+`, normalizamos a E.164)
`message`	string	sí	Texto libre o plantilla `TPL:nombre~var1~var2`

Aliases aceptados: destinatario (= to), mensaje (= message).

Ejemplo¶

curl POST JSONcurl POST formPHP

curl -X POST "https://gw.hybschat.com/mw?appkey=K_ISP_xxx_yyy" \
  -H "Content-Type: application/json" \
  -d '{"to":"51999000111","message":"Hola"}'

curl -X POST "https://gw.hybschat.com/mw?appkey=K_ISP_xxx_yyy" \
  -d "to=51999000111&message=Hola"

$ch = curl_init("https://gw.hybschat.com/mw?appkey=$appkey");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
    'to'      => '51999000111',
    'message' => 'Hola',
]));
curl_exec($ch);

Respuesta¶

Éxito (200):

{ "ok": true, "queued_at": "2026-05-20T10:23:45Z" }

Errores comunes:

HTTP	Causa	Acción
400	Falta `appkey`, `to` o `message`	Revisar request
401	`appkey` inválida o revocada	Pedir nueva en el panel
422	Sin integración Chatwoot	Completar onboarding
404	Plantilla TPL no existe	Crear/aprobar plantilla
5xx	Error temporal	Reintentar con backoff

Plantillas (formato TPL)¶

TPL:nombre_plantilla~var1~var2~var3

Separadores aceptados: | o ~.

Rate limits¶

Sin tope fijo por cliente. La infraestructura soporta ~16 req/s sustained. Para campañas masivas (>5000 mensajes en pocos minutos), coordinar con [email protected].