Responder mensajes

Envía texto a una conversación existente usando conversationId, una API key de conexión e idempotencia obligatoria.

POST/v1/connect/relay/{connectionId}/reply

Base URL: https://api.nahui.studio.

Autenticación

Encabezados obligatorios

Authorization: Bearer nhc_...
Idempotency-Key: identificador-unico-del-envio
Content-Type: application/json

La API key pertenece a una sola conexión. No funciona con otro connectionId.

Solicitud

JSON

{
  "conversationId": "ncv_8354e263-3958-4602-b54c-6b6fd84720c2",
  "message": {
    "text": "Tu cita quedó confirmada."
  }
}

message.text es obligatorio y admite máximo 4,000 caracteres.

No se aceptan teléfonos, to, recipient, recipients, wa_id ni variantes equivalentes. Las claves de destinatario se rechazan incluso dentro de objetos anidados.

Respuesta exitosa

200 OK

{
  "success": true,
  "conversationId": "ncv_8354e263-3958-4602-b54c-6b6fd84720c2",
  "delivery": {
    "externalMessageId": "wamid...",
    "status": "sent"
  }
}

Operación duplicada

200 OK

{
  "success": true,
  "duplicate": true
}

Una respuesta duplicada significa que la Idempotency-Key ya fue aceptada. No generes otra clave para forzar un segundo envío.

Idempotency-Key

Obligatoria.
Entre 8 y 200 caracteres.
Caracteres permitidos: letras, números, ., _, :, -.
Debe identificar una operación lógica.
Puede reutilizarse únicamente para reintentar exactamente la misma operación.

Ejemplo recomendado

crm:reply:01J67Y7QY4G7F0KPG8CY5G5C3N