Mensajes#

Con la API, un bot puede escribir a un contacto desde tu propio sistema: recordarle una cita, enviarle un recibo, responder desde un CRM. Para ello usa el método sendMessage: envía un texto, una imagen o un archivo de inmediato e indica si el mensaje salió.

El método sendMessageToQueue está obsoleto y se desactivará: usa sendMessage en las integraciones nuevas.

El mensaje se guarda en la conversación del contacto con el nombre «API»; puedes verlo en Conversaciones y mensajes. No inicia el flujo del bot.

sendMessage#

Envía a un contacto un texto, una imagen o un archivo.

El contacto se indica de una de dos formas: por ID de contacto, contact_id, o por bot e ID en el canal, bot_id, messenger y contact_external_id juntos.

Qué pasar en contact_external_id:

El teléfono se compara carácter por carácter con el número del contacto (el campo phone en las respuestas de los métodos de contactos). La opción más fiable es contact_id, que devuelven los métodos de contactos.

Si se pasan tanto image como file, se envía la imagen.

curl -X POST "https://app.jetbot24.ru/api/v1/sendMessage" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": 4815162, "text": "Emily, tu pedido n.º 1042 ya fue enviado."}'

curl -X POST "https://app.jetbot24.ru/api/v1/sendMessage" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
    "bot_id": 12345,
    "messenger": "telegram",
    "contact_external_id": "123456789",
    "file": "https://example.com/invoices/1042.pdf",
    "filename": "Factura 1042.pdf",
    "text": "Tu factura"
  }'

{
  "success": true
}

{
  "message": "Contact not found"
}

Límite de envío. No más de 10 mensajes cada 10 segundos a un mismo canal. El contador se lleva por cuenta y por separado para cada canal: los 10 segundos empiezan con el primer mensaje y luego el contador se reinicia. Las solicitudes rechazadas no cuentan ni alargan la ventana. Una respuesta 429 lleva el encabezado Retry-After con los segundos que hay que esperar antes de reintentar. El límite general de frecuencia de la API se aplica aparte: consulta Límites.

Errores del método (los generales están en Errores):

Los textos de error llegan en el idioma del encabezado Accept-Language.

sendMessageToQueue#

Advertencia

Este método está obsoleto y se desactivará el 1 de diciembre de 2026: usa sendMessage en su lugar. Hasta entonces, cada respuesta del método lleva los encabezados Deprecation: true y Sunset: Tue, 01 Dec 2026 00:00:00 GMT. A partir del 1 de diciembre de 2026 (00:00 UTC), el método responde con el estado 410: {"error": "This API method was removed on 2026-12-01.", "code": "method_removed"}.

Pone en una cola un mensaje de texto para un contacto. La cola se procesa una vez por minuto.

El contacto se busca entre los contactos de todos tus bots o, con bot_id, solo entre los de ese bot. Pasa al menos uno de contact_id, bitrix_contact_id o phone; si pasas varios, el contacto debe coincidir con todos. Si varios contactos coinciden con phone o bitrix_contact_id y no se pasa bot_id, el mensaje se pone en cola para uno de ellos: primero, un contacto de un canal al que el método puede enviar y que no ha bloqueado el bot; luego, uno cuyo campo phone (WhatsApp) coincida exactamente; luego, el de la conversación más reciente. Los encabezados de respuesta X-Contact-Id y X-Contact-Ambiguous: true muestran a quién fue el mensaje. Con bot_id no se elige: si también coinciden varios contactos de ese bot, el método responde con 422 y no pone el mensaje en cola; pasa contact_id.

curl -X POST "https://app.jetbot24.ru/api/v1/sendMessageToQueue" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{"contact_id": 4815162, "text": "Recordatorio: tu cita es mañana a las 11:00."}'

{
  "error": "Contact not found"
}

{
  "message": "Several contacts of the bot match this data — specify contact_id.",
  "errors": {
    "contact_id": ["Several contacts of the bot match this data — specify contact_id."]
  }
}

Una respuesta correcta tiene el estado 201, el cuerpo vacío y el ID del contacto elegido en el encabezado X-Contact-Id. El phone limpio debe coincidir carácter por carácter con el número del contacto. Para un contacto de un canal al que ya no se admite el envío, el método responde con 422: {"error": "Messenger is not supported"}. Los contactos que se dieron de baja del bot o lo bloquearon no reciben mensajes de la cola: esos mensajes se quitan de la cola en su siguiente ejecución.