## 1. Instalar el paquete Con tu sesión de Salesforce abierta, entra a este enlace: ``` https://login.salesforce.com/packaging/installPackage.apexp?p0=04taj000000A3B7AAK ``` **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

## 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

Detalle de la credencial externa de Treble

## 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. Busca el conjunto de permisos `treble_api_permission`. El conjunto de permisos treble_api_permission

El conjunto de permisos treble_api_permission

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

Sección External Credential Principal Access

Haz clic en **Manage Assignments → Add Assignments** y selecciona los usuarios que van a ejecutar los flows. Administrar asignaciones del conjunto de permisos

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. En Setup, ve a **Process Automation → Flows** y haz clic en **New Flow**. Flows dentro de Process Automation

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

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 Path

Al 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**. Si quieres tener a mano datos del registro, agrega un elemento **Assignment** en la rama asíncrona. Elemento Assignment guardando el nombre del contacto

Elemento Assignment guardando el nombre del contacto

En 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. En la rama asíncrona, haz clic en **+** y elige **Action**. Agregar un elemento al flow

Busca `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](#problemas-frecuentes). Parámetros conversationId y phoneNumber

Parámetro opcional deploymentPhone y el resultado

## 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: ``` Success for conversation and phoneNumber . Response: ... ``` o, cuando algo falla: ``` Error: 401 Unauthorized ``` 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](/es/docs/integrations/salesforce/blocks/crm-variable-assignment) 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 Para que los asesores respondan sin salir del CRM. Lanzar conversaciones desde Marketing Cloud. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.