All posts

Aquiva blog/Salesforce Releases

Bring Your Own Channel for CCaaS: cómo encajan las piezas

Salesforce documenta bien cada API de BYOC. Armarlas en un contact center es trabajo del integrador: quién maneja cada dirección, para qué sirve un ID estable por mensaje y qué puede llevar un paquete.

Federico Giust, Nicolás Da Silva Ramia

Read in English

Unos auriculares de contact center con el micrófono levantado, frente a una laptop abierta.

Un agente atiende una conversación de WhatsApp en la consola de un contact center externo: el mensaje del cliente está en una pantalla y la ficha del cliente en la otra. El número de pedido lo copia a mano. Cuando la conversación termina, la transcripción queda en la plataforma de CCaaS y el caso queda en Salesforce. En las organizaciones con las que trabajamos, esto se tolera más de lo que se resuelve, porque la solución evidente siempre fue migrar el canal, y nadie quiere migrar el canal.

Bring Your Own Channel for CCaaS es la respuesta de Salesforce: un conjunto de APIs que permite que esa plataforma externa entregue sus conversaciones dentro de la consola nativa de agente. El canal se queda donde está, y el agente deja de cambiar de ventana. Cada pieza está bien documentada por separado: la Interaction Service API, la Pub/Sub API y la Service Connector API para la voz.

Lo que sigue es la versión de ese armado que nos hubiera gustado tener antes de empezar. Cuando algo es comportamiento documentado de Salesforce lo decimos, y cuando fue una decisión nuestra lo decimos también.

Qué implementamos y cuál era el alcance

Lo que construimos es BYOC for CCaaS: la variante de Contact Center as a Service, donde una plataforma externa de contact center lleva sus propios canales a la consola de Salesforce, y no BYOC for Messaging. Todos los canales de mensajería que maneja la plataforma de CCaaS llegan a Salesforce Omni-Channel como un solo canal, así que el agente atiende todas las conversaciones desde la misma consola. También construimos el agente de Agentforce que toma la primera línea de contacto en todos esos canales.

Los supervisores cuentan con Command Center for Service, desde donde monitorean todas las colas, agentes de Agentforce incluidos, en una sola aplicación. La misma construcción se conecta además con Salesforce Voice with Partner Telephony a través de sus propias APIs, y la voz tiene su propia sección más abajo.

El flujo corre en dos direcciones, con dos mecanismos

Comportamiento documentado de Salesforce.

La entrada y la salida usan mecanismos distintos, y conviene tener los dos a la vista desde el principio. En la entrada, el conector del partner arma un payload de Interaction Service y lo envía al endpoint de interacciones. Salesforce crea la sesión de mensajería y el registro de messaging end user, y Omni-Channel enruta el trabajo hacia un agente. En la salida, cuando el agente escribe una respuesta, Salesforce la publica en el custom platform event configurado para el canal. El middleware del partner se suscribe a ese evento mediante la Pub/Sub API y lo procesa por su cuenta o reenvía el mensaje al canal externo.

El custom platform event es el camino de mensajería; la voz no lo usa por defecto. Lleva los mensajes salientes más los indicadores de escritura y de lectura, así que el suscriptor tiene que manejar más que cuerpos de mensaje. El nombre del evento lo define quien implementa: del lado de la plataforma no depende nada de cómo se llame, así que conviene elegir uno que le sirva al suscriptor y después no tocarlo.

Este diseño evita hacer polling contra las APIs de request de Salesforce. No hace que el tráfico sea gratis: Pub/Sub y la entrega de platform events tienen sus propias asignaciones, y esos son los números a vigilar cuando sube el volumen. No publicamos una cifra de nuestra propia implementación, porque no se traslada. Lo que lleva un canal de BYOC depende de la plataforma de CCaaS que tiene delante y de los límites de la organización que tiene detrás.

Standard Omni-Channel llegó al fin de su vida útil con la release Summer '26, y Salesforce actualizó las organizaciones a Enhanced Omni-Channel automáticamente durante el despliegue. Cualquier plan de BYOC escrito sobre Standard hay que releerlo.

La Connect REST API es el camino de lectura que usamos. Su recurso de conversation entries devuelve la transcripción de una conversación, ya sea que la pida la plataforma de CCaaS, un Flow o un Lightning Web Component. Salesforce lo diseñó para conversaciones individuales y lotes pequeños, no para exportaciones masivas, y tiene su propio límite por hora. Salesforce ofrece además una Conversation Data API más nueva para la misma lectura; las dos están descritas en Access Conversation Data.

Tres identificadores hacen tres trabajos distintos

Nuestras decisiones de diseño.

Aprendimos por qué importa la distinción en nuestra propia implementación, cuando un reintento del proveedor dejó el mismo mensaje del cliente dos veces en la pantalla de un agente.

El ID externo de conversación correlaciona; no deduplica. Vincula la conversación del lado del proveedor con la sesión del lado de Salesforce. Una conversación contiene legítimamente muchos mensajes, así que usarlo para detectar duplicados descartaría tráfico real.

Un ID estable por mensaje detecta reenvíos. El ID externo de mensaje, o el ID del payload de interacciones, es lo que indica que el mensaje que está llegando ya fue guardado. Sin eso, cada reintento del proveedor se convierte en una segunda copia en la pantalla del agente, sin forma de saber cuál es la real.

El UUID de la solicitud es para diagnóstico. Sigue una llamada concreta a lo largo de los logs. No es una clave de negocio y no debería usarse como tal.

Lo otro que hay que decidir junto con los identificadores es qué pasa después de un 5xx: reintentar, escalar o mostrarle la falla al agente. Alguien tiene que elegir, y el equipo que no elige ya eligió la primera opción por omisión. Nosotros reintentamos, y cuando se agotan los reintentos, la falla aparece en la consola del agente.

Define el contrato de eventos antes de escribir Apex. Cambiarlo después implica tocar todos los suscriptores a la vez, y los platform events no tienen migración de esquema.

Una MessagingSession no es la conversación completa

Comportamiento documentado de Salesforce.

El modelo de objetos de mensajería tiene más capas de las que la mayoría de los equipos espera. Una Conversation puede contener una o más sesiones de mensajería o llamadas, así que una MessagingSession es una sesión y no todo el historial del cliente.

Los objetos de mensajería que nombra este artículo, simplificados a partir del modelo de objetos de mensajería de Salesforce: un MessagingEndUser tiene muchas Conversations y MessagingSessions, y cada Conversation contiene sesiones, llamadas y registros ConversationEntry guardados fuera del core

Un MessagingEndUser puede tener varios registros de MessagingSession y uno o más de Conversation, y cada Conversation contiene una o más ConversationEntry. En los canales enhanced, que es sobre lo que corre BYOC, las entradas se guardan fuera del core. Un registro de ConversationEntry aparece en la organización cuando termina la sesión, pero su campo Message queda vacío; el texto vive en un almacenamiento aparte y se lee con las APIs descritas arriba. El diagrama completo, con los objetos de participantes y métricas, está en la documentación del modelo de objetos de mensajería de Salesforce.

Para el reporting, esos datos de conversación fuera del core se pueden sincronizar con Data 360, donde se puede reportar sobre ellos y exportarlos en volumen, algo para lo que el recurso de conversation entries no está pensado.

La voz es un proyecto en sí mismo

Salesforce Voice with Partner Telephony, antes Service Cloud Voice with Partner Telephony, sigue una forma parecida: la plataforma de telefonía maneja el ciclo de vida de la llamada, Salesforce crea y actualiza el registro VoiceCall, y el softphone queda dentro de Omni-Channel con los controles de llamada conectados a través de la Service Connector API.

La Service Connector API es una librería JavaScript que se extiende para manejar los eventos de voz. Corre dentro del widget de teléfono de Omni-Channel, escuchando eventos y reenviándolos a donde tienen que ir, y trae métodos para las operaciones soportadas: transferir, colgar, agregar un supervisor y el resto.

La configuración difiere del BYOC de mensajería en la metadata ConversationVendorInfo, que define el tipo de vendor, las URLs del proveedor de telefonía y las funciones que soporta. La voz necesita su propio canal, y el modelo de datos también cambia un poco: las llamadas viven en VoiceCall y, si la grabación está activa, en VoiceCallRecording, mientras que la transcripción reutiliza los mismos objetos Conversation y ConversationEntry.

Las respuestas asistidas corren sobre el prompt template nativo, detrás de un componente custom

Service Cloud ofrece dos formas de hacer respuestas asistidas. La nativa es el componente estándar de Assisted Replies, que está fuertemente acoplado al componente Enhanced Conversation. Uno de nuestros clientes no quería el componente de conversación estándar y había construido el suyo, así que tomamos el otro camino: un Lightning Web Component custom que llama al mismo prompt template en segundo plano. El componente nativo corre sobre un prompt template editable, y el nuestro llama a ese template directamente, así que el agente tiene una experiencia muy parecida y el lado del LLM es exactamente la misma implementación.

Cualquier licencia que dé acceso a prompt templates alcanza para este camino. La lista de abajo está vigente a noviembre de 2026; los nombres de Agentforce vienen de la actualización de empaquetado de Salesforce del 17 de junio de 2025, que reemplazó los add-ons de Einstein y las Einstein 1 Editions:

  • Agentforce 1 Editions (Sales, Service, Field Service y el resto), antes Einstein 1 Editions. Traen Prompt Builder, Data 360 y créditos incluidos, y los contratos firmados bajo el nombre Einstein 1 conservan el mismo derecho.
  • Add-ons de Agentforce por usuario: Agentforce for Sales, Service o Platform, antes Einstein for Sales, Service o Platform. Es la vía más común sobre una organización que ya corre Enterprise o Unlimited.
  • Agentforce con Flex Credits, licenciado a nivel de organización, donde cada invocación de un prompt template consume créditos.
  • Add-ons de Einstein Copilot y Einstein GPT de los contratos de 2023 y 2024, que Salesforce ya migró a los nombres de Agentforce.
  • Developer Edition con Agentforce y Data 360, la edición gratuita para desarrolladores, solo para desarrollo y pruebas.

En nuestra implementación, toda respuesta sugerida requiere revisión del agente antes de poder enviarse. Fue una decisión nuestra, no una limitación de la plataforma, y es la decisión que volveríamos a tomar.

Nada de esto necesita un modelo propio, fine-tuning ni un pipeline de ML. La ingeniería está en las entradas: una transcripción que el template pueda leer, una relación de registros que pueda seguir, y contenido de Knowledge que alguien mantenga al día. El tercero es el que se deteriora en silencio. Una sugerencia apoyada en un artículo que quedó viejo hace un año es peor que ninguna sugerencia, porque suena convincente, y el agente que acepta una equivocada deja de confiar en el panel.

Qué llevó nuestro paquete y qué necesitó igual cada organización

Nuestra experiencia de empaquetado.

Una división binaria entre "empaquetable" y "manual" es demasiado limpia, y además la línea se movió con la plataforma. Tres categorías la describen mejor.

La mayor parte de la construcción viaja en el paquete. Clases Apex y triggers con su cobertura de tests, los Lightning Web Components y la console app, objetos y campos custom, los registros de definición de canal e información de vendor, el custom platform event que lleva el tráfico de salida, y el prompt template custom detrás del componente de respuestas asistidas. Para voz, la Conversation Channel Definition no hace falta y la información de vendor difiere.

Parte de la configuración se hace después de instalar, siempre. Activación, asignación de usuarios, los canales concretos, y las colas y la configuración de enrutamiento. Dependen de la organización y ningún paquete las lleva dentro.

El resto depende de la estrategia de distribución. El manejo de OAuth cambia según la aplicación la distribuya el partner o la configure el cliente, y el empaquetado de prompt templates se movió con la plataforma. Tanto el GenAiPromptTemplate como la External Client App son empaquetables en 2GP, que fue lo que zanjó la discusión. Una aplicación distribuida por el partner tiene que usar External Client Apps, con JWT o con el flujo OAuth de web server.

Sea lo que sea que caiga en la segunda y la tercera categoría, escríbelo como guía de setup y trata esa guía como un entregable.

Decisiones que conviene cerrar antes de la primera línea de Apex

  • Qué canales pasan por BYOC y cuáles se quedan donde están. No todos los canales necesitan una sesión en Salesforce.
  • Qué sistema garantiza un ID estable por mensaje. Si el proveedor no puede prometerlo, lo tendrás que construir tú.
  • Qué hace un mensaje saliente que falla, y quién ve la falla.
  • Si el enrutamiento es Salesforce-owned o partner-owned, porque los eventos que hay que manejar cambian con la respuesta. El nuestro fue partner-owned.
  • De dónde va a salir el reporting, antes de que alguien prometa un reporte unificado.
  • Quién es dueño de Knowledge. Las respuestas asistidas valen lo que valen los artículos que las sostienen, y ese dueño rara vez está en el equipo de integración.

Este artículo acompaña nuestra charla en Mexico Dreamin', en Ciudad de México, el viernes 20 de noviembre de 2026.

Dónde entra Aquiva

Construimos y ponemos en producción integraciones como esta sobre Salesforce, incluyendo el empaquetado y el camino de security review cuando el resultado se va a distribuir y no a usar una sola vez. Si estás evaluando BYOC para una plataforma de CCaaS, o extendiendo Service Cloud con un canal que Salesforce no soporta de forma nativa, hablemos antes de que te comprometas con la arquitectura.

Federico GiustSenior Developer
Nicolás Da Silva RamiaEngineering Director