Handoff humano (origin)

​

Valores de origin

​

Patrón de handoff

// Tu webhook handler
function shouldBotRespond(msg: MessagePublic): boolean {
  // Solo respondemos a mensajes entrantes del contacto
  if (msg.direction !== 'inbound') return false;
  // Si origin no es 'inbound', es algo que generamos nosotros — no entrar en loop
  if (msg.origin !== 'inbound') return false;
  return true;
}

function shouldPauseBot(conversation, recentMessages: MessagePublic[]): boolean {
  // Si el último mensaje saliente fue del panel, un humano está atendiendo
  const lastOutbound = recentMessages.findLast((m) => m.direction === 'outbound');
  return lastOutbound?.origin === 'panel';
}

​

Cómo lo aplicás en webhooks

1. message.received con origin: 'inbound' → procesar normalmente.
2. message.status_changed con origin: 'panel' → marcar la conversación como “humano-controlada”, no responder.
3. message.status_changed con origin: 'external_api' → confirmación de que tu propio mensaje fue entregado.

​

Estado por conversación

• Cuando llega cualquier mensaje saliente con origin: 'panel', marcá la conversación como botPaused: true.
• Cuando llega un mensaje entrante después de N minutos sin actividad humana, podés re-activar el bot (botPaused: false).

​

Origin para mensajes pre-abril 2026 (legacy fallback)

• Mensaje viejo enviado por API con sentBy poblado por error → se clasifica como panel. Workaround: si tu lógica depende del orden de eventos, considerá también metadata.apiKeyId cuando esté presente (mensajes nuevos sí lo setean).
• Mensaje de history sync que ALSO tenía sentByAi: true → clasifica como history (ganaba precedencia). Esos mensajes no son reactivos, ignoralos.

​

Notas adicionales

• metadata.origin es la fuente de verdad en DB; el campo público origin es la versión canónica que vas a usar.