POST https://app.chatnorris.ai/api/v2/chatbots/{chatbot_id}/chat
Authorization: Bearer <tu_api_key>
Content-Type: application/json

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ámetro	Tipo	Descripción
`chatbot_id`	string	ID del agente al que se envía el mensaje

Cuerpo de la request

Campo	Tipo	Requerido	Descripción
`message`	string	✅	Texto del mensaje (1–4000 caracteres)
`conversation_id`	string	—	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

Campo	Tipo	Descripción
`reply`	string	Respuesta generada por el agente
`conversation_id`	string	ID 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

Code	Descripción
`INVALID_INPUT`	El mensaje supera 4000 caracteres o el `conversation_id` no es un UUID válido
`NOT_FOUND`	El agente no existe, está inactivo, o la conversación no pertenece a este agente
`PLAN_LIMIT_REACHED`	Se alcanzó el límite mensual de créditos de IA del plan (o el tope de créditos propio del agente, si tiene uno configurado)

Primeros pasos

Agentes de IA

Widget Web

Canales

Conversaciones y Live Chat

Campañas

Leads y Analíticas

Equipo

Cuenta y configuración

Facturación

Solución de problemas

Preguntas frecuentes

Glosario

API Pública v2

Enviar mensaje (Chat)

Enviar mensaje

Path parameters

Cuerpo de la request

Ejemplo — primer mensaje

Ejemplo — continuar conversación

Respuesta

Campos de respuesta

Cómo funciona el contexto

Errores comunes

​Enviar mensaje

​Path parameters

​Cuerpo de la request

​Ejemplo — primer mensaje

​Ejemplo — continuar conversación

​Respuesta

​Campos de respuesta

​Cómo funciona el contexto

​Errores comunes

Enviar mensaje

Path parameters

Cuerpo de la request

Ejemplo — primer mensaje

Ejemplo — continuar conversación

Respuesta

Campos de respuesta

Cómo funciona el contexto

Errores comunes