Ir al contenido

Canales: interruptores por cuenta y camino heredado

Códigos de error · 17 códigos · 11 por retirar · catálogo del 2026-10-21

Códigos de compatibilidad: los interruptores por cuenta y el camino de envío heredado. Hoy todo número recibe y envía por Boost; estos códigos solo aparecen si una cuenta quedó fuera de ese camino, y desaparecerán junto con él (por eso casi todos están por retirar).

Para toda la familia

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

Cómo se detecta
La respuesta (code) al cambiar los interruptores de una cuenta (solo plataforma) y, desde el chat, la respuesta de un envío cuando la cuenta no sale por la salida directa.
Qué hacer
Todo número tiene que recibir y enviar por Boost (ingress_owner y egress_owner = boost en channel_account_switches). Si un envío cae en uno de estos códigos, revisa los interruptores de esa cuenta y pásala a Boost; desde el chat, el envío tiene que ir por la salida directa.
17 códigos

Códigos

CHANNEL_SWITCHES_NO_WORKFLOW_API_USER

interno

Se pidió prender los workflows de una entidad (Configuraciones > Workflows) y la entidad no tiene usuario API de workflows (entity_workflow_configs.workflow_system_user_id): sin él los workflows fallan, así que no se prendió ninguna cuenta.

Qué hacer
Configurar el usuario de automatización de la entidad (ver el panel de preparación de la entidad) y volver a prender.

INTERACTIONS_OUTBOUND_NOT_DIRECT

HTTPHTTP 400

El envío no salió por la salida directa de Boost (400) y no hay otro camino: el número no sale por Boost (egress_owner = boost) o el envío no pasa por una conversación (sendAndProjectOutbound).

Qué hacer
Revisar el interruptor de la cuenta (yarn -s boost canales cuentas --entidad N) y que el envío salga de un chat. Desde el 14/10/2026 reemplaza a INTERACTIONS_CHANNEL_ACCOUNT_WITHOUT_COMMUNICATIONS e INTERACTIONS_DIRECT_EGRESS_OUT_OF_SCOPE.

INTERACTIONS_TEMPLATES_DIRECT_REQUIRED

HTTPHTTP 409

Las plantillas de este número van directo a Meta desde Boost y eso no está disponible (409): la llave no es de un WhatsApp con WABA en Boost. No hay otro camino.

Qué hacer
Revisar que el número sea de WhatsApp y tenga WABA en Boost; si el error viene como CHANNEL_TEMPLATES_DIRECT_UNAVAILABLE, su token en la bóveda o el permiso interactions.whatsapp_templates.manage.

Por retirar

Todavía existen, pero van a desaparecer junto con el camino que los produce. No los uses en código nuevo.

CHANNEL_ACCOUNT_NOT_FOUND

internopor retirar

La cuenta de canal no existe (interruptores por cuenta).

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_AUDIT_UNAVAILABLE

internopor retirar

No se pudo registrar la decisión de autorización; no se cambió ningún interruptor.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_INGRESS_SKIPS_STEP

internopor retirar

El ingreso se mueve un paso a la vez (communications ↔ shadow ↔ handover ↔ boost) y se pidió saltar uno.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_INVALID_REQUEST

internopor retirar

Pedido de cambio de interruptor mal formado (valor desconocido, sin motivo o más de un interruptor).

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_NO_CHANGE

internopor retirar

El interruptor ya tiene el valor pedido.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_ORDER_A

internopor retirar

Orden A: el despacho por bus exige que la cuenta ya no esté en communications.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_ORDER_B

internopor retirar

Orden B: la salida boost exige despacho bus.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_ORDER_C

internopor retirar

Orden C: el ingreso handover o boost exige salida boost.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_PLATFORM_ONLY

internopor retirar

Solo plataforma puede cambiar los interruptores de una cuenta de canal.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_ROW_EXISTS

internopor retirar

La cuenta ya tiene fila de interruptores; se cambia con PATCH, no se crea otra.

Por retirar
Muere con los interruptores por cuenta.

CHANNEL_SWITCHES_ROW_MISSING

internopor retirar

La cuenta no tiene fila de interruptores; hay que crearla con POST antes de cambiarla.

Por retirar
Muere con los interruptores por cuenta.

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.