Skip to main content
El paquete está en evolución y su enlace de instalación cambia con cada versión nueva. Si algo no coincide con lo que ves en pantalla, confirma con tu Customer Success Manager que estás usando la versión vigente.
Hasta aquí, las conversaciones se disparan desde Treble. Con este paquete puedes hacerlo al revés: un automation flow de Salesforce dispara una conversación de WhatsApp de Treble. Sirve para casos como: cuando un lead cambia a cierto estado, mandarle automáticamente una plantilla de WhatsApp; o cuando se crea una solicitud, iniciar la conversación de seguimiento sin que nadie tenga que hacer nada.

Antes de empezar

La API key es una credencial con acceso a tu cuenta de Treble. No la compartas por canales abiertos, no la pegues en documentos compartidos, y si crees que se expuso, pide que se regenere.

1. Instalar el paquete

Con tu sesión de Salesforce abierta, entra a este enlace:
Sobre el identificador del enlace. La parte final (04taj000000A3B7AAK) es el Id de la versión del paquete. Cuando se publica una versión nueva, ese Id cambia.Si el enlace no abre, te pide una contraseña de instalación, o instala algo que no corresponde con lo que ves aquí, probablemente estés con un enlace viejo: pídele a tu Customer Success Manager el vigente.
Si tu organización es un sandbox, cambia login.salesforce.com por test.salesforce.com en el enlace.
Vas a ver la pantalla de instalación del paquete DeployTrebleConversation. Pantalla de instalación del paquete DeployTrebleConversation Elige quién puede usarlo: Haz clic en Install y espera a que Salesforce confirme la instalación.

2. Configurar la credencial

El paquete instala una credencial externa y una credencial con nombre que son las que permiten a Salesforce llamar a la API de Treble. Detalle de la credencial externa de Treble
1

Abre Setup → Named Credentials

Vas a ver la credencial externa treble_api_external_credential y, relacionada con ella, la credencial con nombre treble_api.
2

Confirma la URL (normalmente no hay que tocarla)

El paquete ya trae la credencial apuntando a https://main.treble.ai. No tienes que configurarla: solo verifica que esté así.
3

Agrega el encabezado de autorización

En la credencial externa, en la sección Custom Headers, haz clic en New y crea:Guarda.

3. Dar permisos a los usuarios

Salesforce no deja usar una credencial externa sin un permiso explícito. El paquete trae un conjunto de permisos listo.
1

Abre Setup → Permission Sets

Busca el conjunto de permisos treble_api_permission.El conjunto de permisos treble_api_permission
2

Confirma el acceso a la credencial

Dentro del conjunto, entra a External Credential Principal Access y verifica que esté el principal de Treble.Sección External Credential Principal Access
3

Asigna el conjunto a los usuarios

Haz clic en Manage Assignments → Add Assignments y selecciona los usuarios que van a ejecutar los flows.Administrar asignaciones del conjunto de permisos
Si el flow se ejecuta de forma automática (por un cambio de registro, no por alguien que hace clic), asigna el permiso al usuario bajo el que corre el flow, no solo a los administradores. Es el error más común en esta parte.

4. Crear el flow que lanza la conversación

Con el paquete instalado y los permisos asignados, la acción de Treble ya está disponible en el Flow Builder de Salesforce. El ejemplo que sigue lanza una conversación de WhatsApp cada vez que se crea una cuenta. La misma estructura sirve para cualquier otro disparador.
1

Entra a Flows

En Setup, ve a Process Automation → Flows y haz clic en New Flow.Flows dentro de Process Automation
2

Elige el tipo de flow

Para que se dispare solo cuando cambian los datos, elige Record-Triggered Flow.Elegir Record-Triggered Flow
3

Configura el disparador y activa la ruta asíncrona

Elige el objeto (en el ejemplo, Account), cuándo se dispara (A record is created), y en Optimize the Flow for elige Actions and Related Records.
Este es el paso que más se olvida. Abajo, activa Add Asynchronous Path.Salesforce no permite llamar a un sistema externo desde la ruta normal de un flow disparado por registro. Sin esta ruta, la acción de Treble fallará.
El interruptor Add Asynchronous PathAl activarlo, el flow se divide en dos caminos: Run Immediately y Run Asynchronously.El flow con las rutas inmediata y asíncrona
Todo lo que llame a Treble va en la rama Run Asynchronously.
4

Opcional: guarda en variables los datos que necesitas

Si quieres tener a mano datos del registro, agrega un elemento Assignment en la rama asíncrona.Elemento Assignment guardando el nombre del contactoEn el ejemplo se guarda el nombre del contacto que disparó el flow en una variable contactname. Lo mismo se hace con el teléfono, que es el dato que sí necesita la acción de Treble.
5

Agrega la acción de Treble

En la rama asíncrona, haz clic en + y elige Action.Agregar un elemento al flowElegir el elemento ActionBusca treble y selecciona Deploy Treble Conversation.Buscar y elegir la acción Deploy Treble Conversation
Si no aparece, es un problema de instalación o de permisos, no del flow. Revisa problemas frecuentes.
6

Llena los parámetros

Parámetros conversationId y phoneNumberParámetro opcional deploymentPhone y el resultado
deploymentPhone viene desactivado (“Not Included”). Actívalo solo si vas a usarlo.
7

Guarda y activa

Haz clic en Save y luego en Activate. Un flow guardado pero sin activar no corre.

Qué hace la acción por dentro

Vale la pena conocer dos cosas, porque definen lo que se puede y lo que no.
La acción devuelve una sola salida, result, con un texto:
o, cuando algo falla:
Si quieres que el flow reaccione al fallo —mandar un correo, marcar un campo— tienes que agregar un elemento Decision que evalúe ese texto, por ejemplo comprobando si empieza por Error. No hay un campo de éxito o fracaso aparte.
La acción le manda a Treble el número de destino y cuál campaña lanzar, y nada más.Eso significa que no puedes pasar valores del registro de Salesforce como variables de la plantilla de WhatsApp desde este flow. La personalización del mensaje tiene que resolverse del lado de Treble: la campaña puede leer los datos de Salesforce con los bloques de CRM una vez iniciada la conversación.Es la limitación que más sorprende de este paquete, y conviene tenerla clara antes de diseñar la automatización.
La acción acepta lotes, así que sirve igual en un flow que procesa un registro o muchos.
Por debajo, la acción llama al endpoint de despliegue de Treble, el mismo que se usa para lanzar campañas por API:

Endpoint de despliegue

Si tienes dos cuentas de Treble conectadas al mismo Salesforce, necesitas configurar el paquete dos veces, cada una con su propia API key. No se pueden unificar los despliegues de las dos cuentas en una sola configuración.

Problemas frecuentes

Es el síntoma clásico de la configuración incompleta: el paquete quedó instalado, pero el encabezado Authorization o el conjunto de permisos no están bien puestos.La recomendación de nuestro equipo de ingeniería en estos casos es desinstalar el paquete y volver a instalarlo siguiendo esta guía paso a paso, en vez de intentar corregir la configuración existente.
Pasa cuando la instalación terminó a medias, incluso si llegó el correo de confirmación de Salesforce.Revisa en Setup → Named Credentials, pestaña External Credentials, que exista treble_api_external_credential. Si no está, desinstala el paquete y vuelve a instalarlo.
Las dos causas habituales:
  1. El encabezado Authorization no está creado, o la API key quedó incompleta.
  2. El usuario que ejecuta el flow no tiene asignado el conjunto de permisos treble_api_permission.
Busca treble en el buscador de acciones: debe aparecer Deploy Treble Conversation, en la categoría Treble.Si no está, confirma que la instalación del paquete terminó correctamente y que tu usuario está dentro del alcance que elegiste al instalar (admins, todos, o perfiles específicos).
Falta activar la ruta asíncrona. Salesforce no permite llamar a un sistema externo desde la ruta inmediata de un flow disparado por registro.Abre Configure Start, activa Add Asynchronous Path, y mueve la acción de Treble a la rama Run Asynchronously.
Es el caso del permiso: un flow automático corre bajo un usuario distinto al tuyo. Asígnale el conjunto de permisos a ese usuario.

Siguientes pasos

WhatsApp dentro de Salesforce

Para que los asesores respondan sin salir del CRM.

Marketing Cloud

Lanzar conversaciones desde Marketing Cloud.