Saltar al contenido principal
Endpoint · POST /conversation/actions
Mueve la conversación a un buzón o a una categoría. Exactamente uno de mailbox | category, nunca ambos. Campos
  • Exactamente uno de mailbox — { name } del buzón — o category — { name } de la categoría (nunca ambos).
En una lista, este objeto va en el array actions de un POST /conversation/actions — ver Armar una lista de acciones.

Ejemplo ejecutable

Un assign_mailbox sobre una conversación identificada por teléfono y canal. Exactamente uno de mailbox o category, nunca ambos — y cada modo se comporta distinto:
  • mailbox — asigna la conversación al buzón exacto que indicas.
  • category — no eliges un buzón: el sistema reparte la carga y asigna la conversación al buzón con menos chats pendientes dentro de esa categoría (útil para distribuir automáticamente entre un equipo). La categoría debe tener al menos un buzón configurado.
Cada canal tiene su categoría Predeterminada, con el buzón por defecto del canal adentro. Con varios canales, category: { name: "Predeterminada" } coincide con varias categorías y responde 409 AMBIGUOUS_CATEGORY. Para mover la conversación al buzón por defecto, pásalo por mailbox con el nombre que da la consulta de Buzones: es único en el business.

Request

Respuesta

202 Accepted — el grupo se aceptó y corre en background. El resultado real por acción no viaja en la respuesta (se consulta después — ver Cómo se ejecuta).
string
Siempre processing: confirma que el grupo fue aceptado y está en ejecución.
integer
Cuántas acciones del array se admitieron para ejecución — no cuántas tuvieron éxito.