Skip to main content

​
Enviar mensaje

Envía un mensaje a un agente y recibe su respuesta generada con IA usando la base de conocimiento del agente. Cada llamada consume un crédito de mensajes de tu plan. 
POST https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}/chat
Authorization: Bearer <tu_api_key>
Content-Type: application/json
Scope requerido: chat:write

​
Path parameters

ParámetroTipoDescripción
chatbot_idstringID del agente al que se envía el mensaje

​
Cuerpo de la request

CampoTipoRequeridoDescripción
messagestring✅Texto del mensaje (1–4000 caracteres)
conversation_idstring—UUID de una conversación existente para continuar el hilo. Si se omite, se crea una conversación nueva.

​
Ejemplo — primer mensaje

{
  "message": "¿Cuáles son los horarios de atención?"
}

​
Ejemplo — continuar conversación

{
  "message": "¿Y los fines de semana?",
  "conversation_id": "conv_abc123"
}

​
Respuesta

{
  "status": "success",
  "data": {
    "reply": "Nuestros horarios de atención son de lunes a viernes de 9:00 a 18:00 hs.",
    "conversation_id": "conv_abc123"
  }
}

​
Campos de respuesta

CampoTipoDescripción
replystringRespuesta generada por el agente
conversation_idstringID de la conversación (nueva o existente). Usalo en próximas llamadas para mantener el contexto.

​
Cómo funciona el contexto

Cada request que incluye el mismo conversation_id mantiene el historial de los últimos 10 mensajes de la conversación. Esto permite conversaciones multi-turno coherentes. Sin conversation_id, cada llamada es una conversación independiente sin contexto previo.

​
Errores comunes

CodeDescripción
INVALID_INPUTEl mensaje supera 4000 caracteres o el conversation_id no es un UUID válido
NOT_FOUNDEl agente no existe, está inactivo, o la conversación no pertenece a este agente
PLAN_LIMIT_REACHEDSe alcanzó el límite de mensajes mensual del plan