Ir al contenido
Boost

Interacciones: chat, bandeja y plantillas

Códigos de error · 43 códigos · catálogo del 2026-10-21

El chat de Boost: bandeja, historial, salida de mensajes desde el chat, plantillas de WhatsApp, links de pago y notas.

Para toda la familia

Lo que un código no dice lo hereda de aquí.

Cómo se detecta
El code viaja en la respuesta al front (DevTools → Red). Render solo muestra la petición y su status.
Qué hacer
La mayoría son de configuración del canal (número sin cuenta, canal sin configurar, contacto sin teléfono). Revisa la cuenta del canal en Configuración → Canales y los datos del contacto.
43 códigos

Códigos

CHAT_NOTE_NOT_OWNER

HTTPHTTP 403

Una nota interna del chat la edita solo quien la escribió; la borra su autor, plataforma o quien tiene settings.manage en la entidad.

CONTACT_MERGE_AUDIT_UNAVAILABLE

HTTPHTTP 503

Unir contactos: no se pudo registrar la decisión en authz_decisions; no se unió nada (503).

Qué hacer
Revisar la auditoría de Roles (AuthzAuditService) y reintentar.

CONTACT_MERGE_BLOCKED

HTTPHTTP 409

Unir contactos: al borrar el contacto origen, una FK todavía lo referenciaba; la transacción se deshizo completa.

Causa típica
Una tabla nueva con contact_id hacia contacts que la unión no sabe mover.
Cómo detectarlo
Log 🔴 [contact-merge] un contacto origen sigue referenciado en Render, con el error de MySQL.
Qué hacer
Agregar la tabla a applyContactMerge (src/interactions/contact-merge/contact-merge.store.ts) y a su laboratorio.

CONTACT_MERGE_RETRY

HTTPHTTP 409

Unir contactos: MySQL eligió la unión como víctima de un deadlock (1213) dos veces seguidas. La unión se reintenta UNA vez entera; la segunda vez responde 409 y no se unió nada.

Causa típica
Otra transacción tomaba al mismo tiempo las mismas filas en otro orden, por ejemplo la página web de Workflows (bloquea la sesión y después la ejecución) o un paso del motor.
Cómo detectarlo
Logs 🟠 [contact-merge] deadlock (1213) en Render: el primero dice que se reintenta y el segundo que no se unió nada.
Qué hacer
Volver a intentar. Si se repite con los mismos contactos, revisar qué otra transacción toca sus ejecuciones o sesiones de la página web.

CONTACT_MERGE_STALE_PREVIEW

HTTPHTTP 409

Unir contactos: algo de los contactos cambió entre la vista previa y la unión (canales, identidades, chats, ejecuciones). No se unió nada.

Qué hacer
Volver a pedir la vista previa y confirmar otra vez.

CONTACT_MERGE_TWO_FACEBOOK

HTTPHTTP 409

Unir contactos: la unión dejaría a un contacto con dos cuentas de Messenger distintas (PSID). No se une nada.

Causa típica
Por contacto, como máximo un WhatsApp, un Facebook (Messenger) y un Instagram.
Qué hacer
Es la regla: se quedan como contactos separados.

CONTACT_MERGE_TWO_INSTAGRAM

HTTPHTTP 409

Unir contactos: la unión dejaría a un contacto con dos cuentas de Instagram distintas (IGSID). No se une nada.

Causa típica
Por contacto, como máximo un WhatsApp, un Facebook (Messenger) y un Instagram.
Qué hacer
Es la regla: se quedan como contactos separados.

CONTACT_MERGE_TWO_WHATSAPP

HTTPHTTP 409

Unir contactos: la unión dejaría a un contacto con dos números de WhatsApp distintos. No se une nada y el segundo sigue siendo otro contacto.

Causa típica
Por contacto, como máximo un WhatsApp, un Facebook (Messenger) y un Instagram. El mismo número en dos formatos (con y sin código de país) sí se une.
Qué hacer
Es la regla, no un fallo: si son dos personas, se quedan separadas. Si es la misma persona con dos números, hoy no se pueden unir.

CONTACT_MERGE_WORKFLOW_QUEUED

detalle

Unir contactos: hay un flujo a punto de correr (queued_wait_conflict) para alguno de los dos contactos. No existe un estado queued (ExecutionStatus).

Qué hacer
Reintentar en unos segundos.

CONTACT_MERGE_WORKFLOW_RUNNING

detalle

Unir contactos: hay una ejecución de workflow running de alguno de los dos contactos. No se toca a mitad de un paso (regla de Workflows).

Qué hacer
Reintentar en unos segundos. Si no se libera, es un running zombie: lo cierra el janitor del motor.

INTERACTIONS_CONTACT_INACTIVE

HTTPHTTP 409

Envío (409) a un contacto inactivo, de una persona o de la automatización: mensaje, media, plantilla, inicio con plantilla, producto o cotización del catálogo, link de pago, respuesta rápida, auto-respuesta, sesión de compra o correo. No sale nada ni se escribe en la timeline.

Causa típica
El contacto está inactivo (borrar un contacto lo inactiva) y alguien le escribe desde un chat abierto antes o por un enlace viejo, o un workflow que no pasa por los selectores de destinatario intenta escribirle (sus ejecuciones vivas se cancelan al inactivarlo). Un entrante lo reactiva antes de que corra cualquier workflow.
Cómo detectarlo
La respuesta (code, con contact_id); en Render, [interactions.contact-inactive] envío rechazado … automation=<true|false>; en un workflow, la ejecución queda en paused_error con el mensaje. En la base: contacts.deactivated_at del contacto de la conversación.
Qué hacer
El contacto se reactiva solo si el cliente escribe, o al crearlo de nuevo con su número.

INTERACTIONS_OUTBOUND_CHANNEL_ACCOUNT_FORBIDDEN

HTTPHTTP 403

La persona no tiene permitido enviar con el número por defecto del chat (o con el que eligió).

Causa típica
El número no está asignado a esa persona (números por empleado) y no tiene permiso para usar otros.
Qué hacer
Elegir un número emisor asignado a la persona, o asignarle el número en Configuración → Canales.

INTERACTIONS_QUOTE_CHANNEL_UNAVAILABLE

HTTPHTTP 409

La cotización no se puede mandar por correo desde su vista previa (409): el contacto no tiene dirección de correo o el actor no tiene un buzón para escribirle (reason: no_mailbox, no_recipient, no_conversation…).

INTERACTIONS_REPLY_CHANNEL_WINDOW_CLOSED

HTTPHTTP 400

Una persona respondió por un canal o número cuya ventana de 24 h está cerrada, pero OTRO canal del mismo contacto la tiene abierta (el cliente escribió por ahí): el chat único junta WhatsApp, Messenger e Instagram y cada uno tiene su ventana.

Causa típica
El compositor quedó en un canal o número viejo (p. ej. WhatsApp por el número de pruebas) mientras el cliente acaba de escribir por Messenger. Nace del 01/10/2026: la respuesta de la conversación 887 salió por WhatsApp con la ventana vencida y el error decía "solo plantillas".
Cómo detectarlo
Respuesta 400 con reason_code: WINDOW_CLOSED, cause_code (el código original, p. ej. WHATSAPP_SESSION_EXPIRED), el canal y la cuenta que fallaron (channel_type_code, entity_channel_account_id) y open_channels (los abiertos, el del último entrante primero). En Render: [interactions.outbound] ventana cerrada en el canal elegido; abierto …. Solo envíos de una persona; la automatización sigue recibiendo el código original.
Qué hacer
Responder por el canal que trae open_channels[0] (la web ofrece "Enviar por …" en el mensaje que no salió). Si no hay ningún canal abierto, este código no aparece: sale el de siempre y solo queda una plantilla.

INTERACTIONS_WHATSAPP_TEMPLATE_CHANNEL_ACCOUNT_DISCONNECTED

HTTPHTTP 400

El número elegido para crear o borrar plantillas fue dado de baja (account_status = 'disconnected'); hay que usar el número conectado que lo reemplazó.

Causa típica
Una pantalla abierta desde antes de la baja, o una llamada directa a la API con el id viejo: el selector de números ya no ofrece cuentas dadas de baja.
Qué hacer
Recargar la pantalla y elegir el número conectado.

INTERACTIONS_WHATSAPP_TEMPLATES_RATE_LIMITED

HTTPHTTP 429

Meta limitó temporalmente las lecturas de plantillas de la WABA (429). Nunca se disfraza de 500.

Causa típica
Demasiadas lecturas de plantillas en poco tiempo (Meta #80008).
Cómo detectarlo
Respuesta 429 con retry_after_seconds / retry_at tal como los dio Meta, o en null si no los dio (constraint.whatsapp-templates-rate-limit-is-a-typed-429-never-a-local-guess-2).
Qué hacer
Esperar; el front muestra la espera sin cuenta regresiva si no hay tiempo. No reintentar en bucle.

payment_link_not_sent

HTTPHTTP 502

El link de pago se generó pero no se pudo mandar por WhatsApp; la respuesta trae el payment_url para mandarlo a mano.

Texto generado desde el catálogo de errores de BoostAPI. Para corregirlo, se cambia allá y se sincroniza: verMantener esta documentación. También enMarkdown.