# Sección de Administrador
Source: https://help.treble.ai/es/docs/agent-platform/admin/admin-section
En la sección de administrador, podrás ver el estado de tus conversaciones, ver qué agentes tienen asigandas conversaciones, y usar filtros para ver las conversaciones.
# Vista de Conversaciones
El administrador podrá filtrar **por cliente** (con el número de teléfono o nombre). Por **tiempos de respuesta**, por **estados** (chat asignados, chats finalizados), por **grupos o equipos** y **por etiquetas**.
Además, en cada chat puede seleccionar los **3 puntos** para ver el **historial del chat**, las **notas** del mismo y/o **transferirlo**.
## Métricas principales
En la sección superior de esta vista, podrás ver las métricas principales de las conversaciones. Podrás ver:
1. **Chats sin asignar**: Son los chats que no han sido asignados a ningún agente.
2. **Chats activos**: Son los chats que han sido asignados a un agente.
3. **Chats finalizados hoy**: Son la cantidad de chats que han sido finalizados por un agente.
4. **Grupo con mayor carga hoy**: Es el grupo con más chats asignados.
Recuerda que tus agentes están asignados a un grupo. El grupo con mayor carga hoy, es el grupo con más chats asignados.
# ¿Cómo revisar las conversaciones desde el panel de administración?
Desde la sección **Admin > Conversaciones**, puedes consultar en detalle todas las interacciones que tus agentes tienen con los clientes. Esta vista centralizada te permite auditar el rendimiento, verificar el estado de las conversaciones y entender la carga de trabajo de tu equipo.
## ¿Qué información puedo consultar?
Al ingresar a la sección de **Conversaciones**, verás un listado de todas las conversaciones registradas en tu cuenta. Cada fila del listado representa una conversación individual y muestra la siguiente información:
* **Cliente:** Número de teléfono e identificador asignado en WhatsApp.
* **Vendedor:** Agente que atendió la conversación.
* **Grupo:** Grupo al cual pertenece el agente (por ejemplo, "default").
* **Fecha de creación:** Momento exacto en que inició la conversación.
* **Duración:** Tiempo total que duró la conversación.
* **Calificación:** Valoración opcional si el cliente dejó una nota o puntaje.
* **Estado:** Puede estar “En proceso” o “Cerrada”.
* **Tiempo de inactividad:** Cuánto tiempo ha pasado desde el último mensaje.
* **P. respuesta (creación):** Tiempo entre la creación de la conversación y el primer mensaje recibido.
* **P. respuesta (asignación):** Tiempo entre la asignación del agente y su primer mensaje.
* **Enviado por:** Indica si el mensaje inicial fue enviado por el cliente o el agente.
## Filtros disponibles
En la parte superior del módulo, puedes aplicar distintos filtros para encontrar conversaciones específicas:
* **Rango de fechas:** Define desde qué fecha hasta cuál deseas consultar.
* **País:** Filtra por el país del cliente.
* **Tiempo sin respuesta:** Ideal para detectar conversaciones inactivas.
* **Estado de conversación:** Abierta, cerrada o en proceso.
* **Grupo de agentes:** Para visualizar la carga por equipo.
* **Etiquetas:** Si tienes etiquetas personalizadas para organizar mejor tus flujos.
Además, puedes buscar conversaciones directamente por nombre o número del cliente usando el buscador.
## ¿Qué puedo hacer con cada conversación?
Al hacer clic en los tres puntos verticales (⋯) al final de cada fila, accederás a más opciones, como ver el historial completo del chat, reenviar la conversación o tomar acciones administrativas (dependiendo de los permisos de tu rol).
# Transferir un chat como administrador
Al hacer click en los 3 puntos de un chat, podrás ver las opciones de transferir el chat a otro agente o grupo. Al hacer click en **Transferir**, podrás seleccionar el agente o grupo al que deseas transferir el chat.
1. Si seleccionar un grupo, el chat se transferirá a uno de los agentes que pertenezcan a ese grupo. Las reglas de asignación de chats a agentes se manejan desde el panel de configuración.
2. Si seleccionar un agente, el chat se transferirá directamente a ese agente. Para seleccionar un agente, debes hacer click en el nombre del agente y luego uno de los grupos a los que pertenece.
## ¿Cómo ver el historial y notas del chat?
Al hacer click en los 3 puntos de un chat, y luego **Ver detalles**, podrás ver las opciones de ver el historial del chat, ver las notas del chat y transferir el chat. Al hacer click en **Conversación**, podrás ver el historial completo del chat. Al hacer click en **Notas**, podrás ver las notas del chat.
# Agentes
Source: https://help.treble.ai/es/docs/agent-platform/admin/agents
En la sección de agentes, podrás ver los agentes de tu operación, sus métricas y sus conversaciones. Podrás manejar a tus agentes, asignarles roles, crear equipos y más.
Desde la sección **Agentes**, puedes gestionar a todos los miembros de tu equipo que atienden conversaciones en Treble. Aquí podrás ver el estado de conexión de cada agente, su rendimiento promedio y otros indicadores clave para monitorear la operación en tiempo real. Exploremos cada sección en detalle.
## Finalización de Conversaciones
Puedes activar la opción de finalizar conversaciones de forma automática. Esta configuración cierra de forma automática las conversaciones que estén asignadas o pendientes por asignación. El tiempo se toma desde la última respuesta del cliente. Puedes especificar el tiempo en minutos.
# Próximos pasos
Configura equipos de agentes en Treble.
# Configuración
Source: https://help.treble.ai/es/docs/agent-platform/admin/configuration
Desde este panel puedes gestionar los contactos visibles para los agentes, controlar el uso de plantillas de mensajes HSM, personalizar las propiedades de HubSpot que se muestran en el chat y definir las reglas de asignación de conversaciones.
# Visibilidad de contactos para agentes
En la pestaña de agentes puedes configurar qué contactos puede visualizar cada agente en la plataforma.
### ¿Por qué es útil?
Esta configuración permite adaptar el acceso a los contactos según la estructura y operación de tu equipo. Es especialmente útil si:
* Cada agente gestiona su propia cartera.
* Necesitas limitar el acceso por campaña o segmento.
* Quieres mantener la confidencialidad de la información.
### Paso a paso para configurar la visibilidad de contactos
Ve a **Configuración > Agentes** en el menú lateral de la plataforma.
Elige cómo deseas que tus agentes visualicen la lista de contactos de la empresa. Puedes escoger cualquiera de las siguientes opciones:
Todos los agentes ven la base de contactos de la cuenta, sin importar la propiedad en el CRM.
**Recomendado para equipos que trabajan colaborativamente sobre una misma cartera.**
Cada agente ve únicamente los contactos que tiene asignados.
**Útil para operaciones segmentadas por agente, campaña o región.**
Una vez selecciones una opción todos los contactos se actualizarán.
Recuerda que puedes ajustar esta configuración en cualquier momento para adaptarla a los cambios en tu equipo o estrategia.
# Visibilidad de plantillas HSM
Aquí puedes definir qué equipos pueden acceder y utilizar cada plantilla HSM disponible en la plataforma, ayudando a mantener la organización y el control sobre los mensajes que se envían.
### ¿Por qué es útil?
Esta funcionalidad permite mantener la operación organizada cuando trabajas con múltiples equipos (ventas, soporte, cobranza, etc.). Asignar permisos por equipo ayuda a:
* Evitar el uso incorrecto de plantillas.
* Mostrar solo los mensajes relevantes para cada equipo.
* Facilitar la administración y el control de mensajes enviados.
Consejo: Si tienes plantillas duplicadas o en desuso, considera hacer limpieza antes de ajustar los permisos.
### Paso a paso para gestionar la visibilidad de plantillas
Ve a **Configuración > HSM** para ver todas las plantillas disponibles y modificar sus permisos de uso.
**En la tabla de plantillas verás:**
* **Plantilla HSM:** Nombre y fragmento del mensaje.
* **Categoría:** Clasificación asignada (por ejemplo, "Marketing" o "Soporte").
* **Permisos:** Equipos con acceso a la plantilla.
* **Fecha de última modificación:** Última vez que se editó la plantilla
Haz clic en la columna **Permisos** de la plantilla que deseas modificar y marca o desmarca los equipos según corresponda. También puedes seleccionar **Todos los equipos** para habilitar el uso global de la plantilla.
Una vez que hayas seleccionado los equipos, haz clic en **Guardar cambios** para aplicar la configuración.
Si una plantilla aparece como "Ninguno de los equipos", no estará disponible para ningún agente.
Así puedes mantener el control sobre qué equipos pueden usar cada plantilla y evitar confusiones en la operación diaria.
# Personalización del propieades de contacto HubSpot (beta)
Controla qué propiedades de HubSpot se muestran en el panel lateral del chat de los agentes, y define si pueden o no editarlas.
### ¿Por qué es útil?
Este panel está diseñado para ofrecer **contexto rápido** sobre el contacto y permitir **actualizar información sin salir del chat**.
Es especialmente útil si:
* Tus agentes necesitan consultar datos clave del CRM mientras conversan.
* Quieres mantener actualizada la información sin abrir HubSpot.
* Buscas mejorar la eficiencia operativa y la calidad de los datos.
Esta funcionalidad está en fase **beta**. Actualmente no todas las propiedades son compatibles.
### Paso a paso para personalizar el panel de contacto
Ve a **Configuración > HubSpot** para personalizar qué propiedades se mostrarán en el panel de contacto.
Usa el buscador para encontrar la propiedad específica que quieres agregar al panel.
Marca la casilla correspondiente para que la propiedad seleccionada se muestre en el panel de contacto.
Usa el switch en la columna "¿Propiedad editable?" para permitir o no su edición por parte del agente.
Arrastra y suelta las propiedades en el orden que prefieras. La vista previa a la derecha te mostrará cómo se verá en el chat.
Una vez que hayas personalizado el panel a tu gusto, asegúrate de guardar los cambios para que se apliquen.
Esta personalización te ayuda a mostrar solo la información relevante para tus agentes y mantener el flujo de trabajo ágil.
Algunas propiedades como las de tipo **fecha** no están disponibles. Si no encuentras una propiedad, probablemente no esté soportada por el panel actual.
# Configuración de asignación de chats
Define cómo se asignan los chats a los agentes y cuántas conversaciones pueden manejar al mismo tiempo.
**Esta configuración funciona como método de respaldo.** Si una conversación pasa por un bloque de [Métodos de transferencia](/es/docs/build-with-treble/blocks/transfer-methods/overview), el método definido en ese bloque **tiene prioridad** sobre lo que configures aquí, y lo de aquí se aplica solo si ese método no logra asignar la conversación. Para las conversaciones que no pasan por ese bloque, esta configuración sigue siendo la que decide.
### ¿Por qué es útil?
Una configuración clara de asignación:
* Evita que los chats se queden sin atender.
* Reduce la sobrecarga en agentes.
* Alinea la operación con la lógica de asignación definida en HubSpot (si aplica).
### Configuración de asignación: dos elementos clave
La asignación de chats se compone de **dos elementos principales** que puedes configurar según las necesidades de tu operación:
1. **Método de asignación**
2. **Máximo de chats por agente**
A continuación te explicamos cada elemento:
***
#### 1. Método de asignación
**¿Qué es?**\
El método de asignación define cómo se decide a qué agente se le asigna cada chat nuevo.
**Existen dos métodos de asignación de chats:** un método primario (disponible para clientes con integración de HubSpot o Salesforce) y un método secundario (propio de Treble).
Puedes activar o desactivar el método primario según tus necesidades; si lo desactivas, solo se usará el método secundario para asignar los chats.
#### Método primario (integración con HubSpot o Salesforce)
Si tienes integración, puedes elegir que el chat se asigne automáticamente al agente propietario definido en tu CRM. Existen tres formas de hacerlo y las puedes elegir dándo click en el botón **Cambiar método**:
El chat se asigna de inmediato al agente propietario, esté o no conectado. Es la opción más rápida y directa.
Se espera un tiempo definido a que el agente propietario esté disponible. Si no lo está, pasado ese tiempo se aplica el método alternativo.
El chat solo se asigna si el agente propietario está conectado; si no, queda pendiente hasta que se conecte.
#### ¿Qué pasa si el método primario no puede aplicarse?
Si el agente propietario no está disponible (por ejemplo, no está activo, no existe, o se supera el tiempo de espera), el sistema puede dejar el chat en cola de espera o pasar automáticamente al método secundario para asegurar que el chat sea atendido.
#### Método secundario (fallback automático)
Cuando el método primario no es posible, Treble busca un agente alternativo **filtrando los agentes disponibles por tag y luego aplicando uno de los siguientes algoritmos.**
El chat se asigna al agente disponible que tenga menos chats activos en ese momento, ayudando a balancear la carga de trabajo. Solo se consideran agentes con la etiqueta correspondiente.
El chat se asigna aleatoriamente entre los agentes disponibles con la etiqueta adecuada, siempre respetando las segmentaciones configuradas.
Cuando no se encuentre ningún agente dentro del tag seleccionado el sistema buscará dentro de la tag default de la empresa.
Si no usas ninguna integración encontrás disponible el método de asignación de treble. Para escoger la alternativa que se adapte mejor a tu operación sólo debes dar click en el botón **Cambiar método** y elegir una opción.
En este método de asignación treble busca un agente disponible **filtrándolos por tag y luego aplicando uno de los siguientes algoritmos.**
El chat se asigna al agente disponible que tenga menos chats activos en ese momento, ayudando a balancear la carga de trabajo. Solo se consideran agentes con la etiqueta correspondiente.
El chat se asigna aleatoriamente entre los agentes disponibles con la etiqueta adecuada, siempre respetando las segmentaciones configuradas.
Cuando no se encuentre ningún agente dentro del tag seleccionado el sistema buscará dentro de la tag default de la empresa.
Esto garantiza que ningún chat quede sin atender, incluso si el propietario original no puede recibirlo.
***
#### 2. Máximo de chats por agente
**¿Qué es?**\
Permite definir cuántos chats puede manejar cada agente al mismo tiempo.
**Opciones:**
Los agentes recibirán todas las nuevas conversaciones que lleguen, sin restricción de cantidad.
Puedes definir un número máximo de chats por agente, ideal para evitar sobrecarga y mejorar la atención.
Selecciona la opción que mejor se adapte a tu operación y ajusta el número con los controles disponibles.
***
Si configuras bien la asignación, tu equipo podrá atender los chats de manera más eficiente y equilibrada, asegurando que ningún cliente quede sin respuesta.
## Preguntas frecuentes
Depende del método elegido. Puede esperarse un tiempo, usar el método secundario, o llevarse a una cola donde estará pendiente de asignación.
Se cuentan solo los chats activos en tiempo real, respetando las etiquetas configuradas.
Sí. El método secundario está disponible para todas las cuentas.
Sí, si eliges el método "asignar inmediatamente" o "asignar aunque no esté conectado".
# Métricas
Source: https://help.treble.ai/es/docs/agent-platform/admin/metrics
En la sección de métricas, podrás ver las métricas de tus conversaciones, agentes y grupos. Esto te ayudará a entender el estado de tu operación con mayor detalle.
En este artículo te guiaremos por las métricas disponibles en **sales.treble.ai** y te mostraremos por qué son fundamentales para el éxito operativo de tu empresa. Las métricas no son solo números: son una herramienta clave para entender qué está funcionando, qué necesita ajustarse y cómo mejorar continuamente.
Aquí descubrirás cómo medir el **performance de tus agentes** y el **alcance real de tus campañas**, lo que te permitirá tomar decisiones más estratégicas, ágiles y orientadas a resultados. Si buscas optimizar tu operación comercial con información confiable y accionable, este artículo es para ti.
# ¿Por qué es importante monitorear a tus agentes?
Como administrador de la plataforma de agentes, es importante que analices el desempeño de los agentes de ventas y verifiques si están prestando la debida atención a cada usuario.
El monitoreo diario de los agentes es clave para identificar el volumen de chats en su bandeja de entrada, el tiempo de respuesta, así como la duración y los periodos de inactividad de las conversaciones.
## Donde encontrar el panel de métricas
Para acceder al panel de métricas, primero, inicia sesión en tu cuenta de
y luego, debes ir a la sección de **Métricas**. Recuerda que para acceder a esta sección, debes ser administrador de la plataforma.
En esta ventana, puedes hacer filtros por equipo, vendedores o etiquetas, con un resumen de métricas de tu operación de vendedores. También tienes la opción de aplicar filtros por fechas.
Ahora vamos a explicar una por una para que saques su mayor provecho
## Métricas disponibles
### Filtros
En la parte superior del **panel de métricas**, encontrarás la opción de **filtros**, una herramienta esencial para ajustar la visualización de los datos según lo que necesites analizar.
Podrás aplicar diferentes tipos de filtros:
• **Por Equipos**: aquí puedes seleccionar cualquiera de los equipos que hayan sido previamente creados en la plataforma.
• **Por Vendedores**: verás a todos los vendedores que están registrados en la plataforma, lo que te permite analizar el rendimiento individual de cada uno.
• **Por Etiquetas**: permite filtrar por cada una de las etiquetas que hayas creado, útiles para clasificar conversaciones por campañas, productos, segmentos, etc.
Además, encontrarás otros filtros clave:
• **Por País**: este filtro te permite segmentar los chats según el código de país desde el cual se generaron.
• **Por Fecha**: incluye opciones predefinidas como *Hoy*, *Ayer*, *Últimos 7 días*, *1 mes* y *3 meses*.
También puedes personalizar el rango de fechas que deseas consultar utilizando el ícono de calendario.
Sales solo muestra las métricas correspondientes a los **últimos 90 días** (contando desde el día actual). Si necesitas acceder a información anterior, deberás solicitarla directamente al equipo de soporte.
No olvides dar clic en Aplicar filtros para que se ejecute tu selección
### Dinámica y volumen de chats
En la segunda parte del **panel de métricas**, encontrarás información clave para entender el volumen y la dinámica de atención en tu operación. Aquí podrás ver tres indicadores principales:
* **Chats recibidos**: representa la cantidad total de conversaciones que han llegado a la plataforma, sin importar si fueron respondidas o no. Este dato te ayuda a dimensionar la demanda que estás recibiendo.
* **Contactos distintos**: te muestra cuántos usuarios únicos se han puesto en contacto contigo. Es útil para identificar el alcance real de tus campañas o entender cuántos clientes nuevos estás atendiendo.
* **Conversaciones transferidas**: indica cuántas veces se ha transferido una conversación entre agentes. Este número puede ayudarte a detectar cuellos de botella o necesidades de capacitación dentro del equipo.
Justo debajo de estos indicadores, encontrarás una **gráfica interactiva** que visualiza estos tres datos. Puedes personalizar su vista para analizar los resultados por **día**, **semana** o **mes**, lo que te permite identificar patrones y tendencias en diferentes periodos de tiempo.
### Tiempos
En la **tercera parte del panel de métricas**, podrás analizar en profundidad los **tiempos de atención** y los puntos críticos en el flujo de las conversaciones. Esta sección permite evaluar la eficiencia de tus vendedores y detectar oportunidades de mejora en la operación.
Aquí encontrarás los siguientes indicadores:
• **Chats pendientes por asignar**: muestra la cantidad de conversaciones que han llegado, pero que aún no han sido asignadas a ningún vendedor.
Este dato te ayuda a identificar si hay cuellos de botella o si se necesita ajustar la distribución de carga entre los equipos.
• **Primera interacción (Chat)**: mide el tiempo que pasa desde que el chat es asignado a un vendedor hasta que ese vendedor envía su primera respuesta.
Este indicador refleja la **agilidad de respuesta una vez que el agente ya tiene el chat en sus manos**.
• **Primera respuesta (Vendedor)**: calcula el tiempo desde la creación del chat (cuando el cliente envía el primer mensaje) hasta que el vendedor responde por primera vez.
Este es un buen reflejo del **tiempo total de espera del cliente desde que inicia el contacto**.
• **Finalización por vendedor**: mide cuánto tiempo pasa desde que se crea el chat hasta que es finalizado por el agente.
Es útil para entender cuánto dura el ciclo completo de una conversación.
• **Resolución del chat**: muestra el tiempo que toma resolver una conversación desde que fue asignada hasta su finalización.
Este indicador te da visibilidad sobre **la eficiencia del agente al manejar chats activos**.
Debajo de estos indicadores, verás una **gráfica interactiva** que te permite visualizar cada una de estas métricas con claridad. Puedes elegir ver los resultados por **día**, **semana** o **mes**, según el periodo que quieras analizar.
Además, encontrarás una **tabla detallada** que muestra los tiempos promedio, los porcentajes de cumplimiento y la cantidad de chats evaluados en cada métrica.
### Calificación de atención/encuesta de satisfacción
En la **cuarta parte del panel de métricas**, podrás visualizar la **satisfacción de tus clientes**, un elemento clave para evaluar la calidad del servicio que estás ofreciendo.
Esta sección muestra la **calificación promedio** que los usuarios han dado a los agentes luego de sus interacciones. Esta métrica te permite identificar si los clientes están teniendo una buena experiencia o si hay puntos de mejora en la atención.
Además de la calificación general, encontrarás una **gráfica interactiva** que te permite visualizar cómo ha evolucionado la satisfacción a lo largo del tiempo. Puedes cambiar la vista para ver los resultados **por día, semana o mes**, y así identificar patrones o variaciones en la calidad de la atención.
Justo debajo, verás una **tabla detallada** donde se agrupan las calificaciones recibidas de **1 a 5 estrellas**, incluyendo:
• El **porcentaje** de respuestas que representa cada calificación.
• El **número total** de respuestas por cada nivel de satisfacción.
Esta sección también cuenta con filtros por **día, semana o mes**, lo que te da flexibilidad para analizar la información según el periodo que te interese.
### Datos de Interacción
En la **quinta y última parte del panel de métricas**, encontrarás una vista enfocada en los **patrones de interacción** de tus usuarios, ideal para entender **cuándo** ocurre el mayor volumen de conversaciones y ajustar tus recursos de forma más estratégica.
Esta sección te muestra:
• **Días con más chats**: identifica los días de la semana en los que recibes mayor volumen de conversaciones, basado en datos promedio.
• **Días con menos chats**: muestra los días con menor actividad, lo que te permite balancear mejor la carga operativa.
• **Horas con más chats**: destaca las franjas horarias con mayor flujo de mensajes, ayudándote a optimizar la disponibilidad de tu equipo.
Todos estos datos se presentan en formato promedio, para que tengas una visión más clara y consistente del comportamiento general de tus clientes.
Además, esta vista incluye un **mapa de calor** que refleja de forma visual los momentos de mayor y menor actividad, cruzando días y horas. Mientras más intenso el color, mayor es el volumen de chats en ese momento.
# Plantillas de Respuestas Rápidas
Source: https://help.treble.ai/es/docs/agent-platform/admin/quick-responses
Las plantillas de respuestas rápidas son mensajes predefinidos que puedes usar para responder a tus clientes de manera rápida y eficiente. Esto permite a tus agentes poder seleccionar una respuesta rápida y enviarla a tus clientes.
En **Treble.ai**, la **biblioteca de mensajes rápidos pre-editados** es un recurso esencial para hacer la atención **más eficiente, estandarizada y ágil**. Con esta funcionalidad, los agentes pueden responder preguntas frecuentes e interactuar con los clientes de forma **rápida y consistente**, sin necesidad de escribir la misma información repetidamente.
## **¿Cómo funciona la biblioteca de mensajes rápidos?**
Treble.ai permite que los agentes almacenen y utilicen **mensajes preconfigurados** para agilizar la atención. Estos mensajes pueden ser utilizados para:
* **Respuestas a preguntas frecuentes**, como horarios de atención e instrucciones de pago.
* **Información estandarizada sobre productos y servicios**.
* **Orientaciones detalladas sobre procesos internos**.
## **Principales beneficios de la biblioteca de mensajes rápidos**
### **Agilidad en la atención**
Con respuestas listas, los agentes reducen el tiempo necesario para atender a cada cliente, garantizando un flujo de comunicación más eficiente.
### **Estandarización y reducción de errores**
Los mensajes pre-editados garantizan que todas las interacciones sigan un **tono de voz uniforme**, evitando variaciones y errores en la comunicación.
### **Facilidad en el entrenamiento de nuevos agentes**
Los nuevos agentes pueden utilizar la biblioteca para **responder con más confianza y precisión**, reduciendo la curva de aprendizaje.
# ¿Cómo gestionar plantillas de respuesta para tu equipo?
Desde la sección **Plantillas**, puedes crear, organizar y actualizar mensajes predefinidos que tus agentes pueden usar para responder de forma rápida, coherente y profesional a los clientes.
Esta funcionalidad es clave para ahorrar tiempo, mantener una comunicación alineada y reducir errores en las respuestas.
## ¿Qué veo en la sección de plantillas?
En esta vista verás todas las plantillas creadas por tu equipo, organizadas en tarjetas que contienen la siguiente información:
* **Nombre de la plantilla:** Aparece como título (por ejemplo, "Campaña Abril").
* **Contenido del mensaje:** Texto que será enviado cuando se use la plantilla.
* **Fecha de creación o modificación:** Visible debajo del mensaje.
* **Grupo asignado:** Indica si pertenece al grupo `DEFAULT` u otro personalizado (como "Equipo Comercial").
* **Acciones rápidas:** Puedes editar una plantilla con el ícono de lápiz ✏️ o acceder a más opciones haciendo clic en los tres puntos ⋯.
## Filtros y búsqueda
Para facilitar la navegación entre muchas plantillas, puedes:
* **Buscar por nombre** usando la barra superior.
* **Ordenar alfabéticamente** o por fecha, usando el selector de orden.
* **Filtrar por grupo** para ver solo las plantillas relevantes para un equipo específico.
## ¿Cómo crear una nueva plantilla?
1. Haz clic en el botón **“Crear nuevo mensaje”** en la parte superior derecha.
2. Escribe un nombre, contenido y selecciona el grupo al que debe pertenecer.
3. Guarda la plantilla y estará disponible inmediatamente para los agentes que pertenezcan a ese grupo.
> 💡 **Consejo:** Puedes usar variables como `{{name}}` para personalizar automáticamente los mensajes con los datos del cliente.
## Buenas prácticas
* Mantén los mensajes breves y claros.
* Usa emojis con moderación para humanizar el mensaje.
* Actualiza las plantillas frecuentemente para que reflejen promociones, políticas o procesos vigentes.
* Crea plantillas por tipo de interacción: ubicación, precios, saludo, promociones, etc.
***
Esta sección es ideal para equipos que manejan altos volúmenes de conversaciones o que necesitan mantener una comunicación estandarizada sin perder el toque humano.
# Equipos de Agentes
Source: https://help.treble.ai/es/docs/agent-platform/admin/tags-teams
Con Treble, puedes crear equipos de agentes para que tus asesores puedan trabajar juntos en las conversaciones de tus clientes.
## Equipos de Agentes
Con Treble, puedes crear equipos de agentes para que tus asesores puedan trabajar juntos en las conversaciones de tus clientes. Piensa en los equipos como agrupaciones de agentes que te permiten organizar tus conversaciones.
Por ejemplo, puedes crear un equipo de agentes para tus conversaciones de ventas y otro equipo para tus conversaciones de soporte.
Esto permite que tus asesores puedan trabajar en diferentes conversaciones sin que se mezclen. Además, puedes asignar permisos a tus asesores para que puedan ver y responder a las conversaciones de tus clientes.
## Roles de agentes
En Treble, los agentes pueden tener diferentes roles. Estos roles te permiten controlar el acceso a las conversaciones de tus clientes.
* **Agentes**: Agentes son los que responden a las conversaciones de tus clientes. Solo pueden responder a las conversaciones que les hayas asignado. Adicionalmente, no pueden acceder a ningún item del panel de control de Treble.
* **Supervisores**: Supervisores tienen mayor control sobre las conversaciones de tus clientes. Los supervisores son ideales cuando quieres tener miembros de tu equipo que puedan monitorizar las conversaciones de tus clientes. Sin embargo, los supervisores no pueden hacer todos los ajustes a la configuración de Treble.
* **Administradores**: Administradores tienen acceso completo a la configuración de Treble. Son los que pueden crear, editar y eliminar equipos de agentes. Adicionalmente, los administradores pueden asignar roles a los agentes y supervisores, al igual que pueden modificar la configuración de Treble.
## Crear un nuevo agente
Para crear un nuevo agente, ve a la sección de **Agentes** en el panel izquierda de control de la plataforma de agentes. Allí podrás ver los agentes que tienes creados y crear uno nuevo. Para hacerlo, haz click en el botón **Crear nuevo vendedor**. Aqui debes agregar la siguiente información:
* **Nombre**: El nombre del agente.
* **Apellidos**: Los apellidos del agente.
* **Email**: El email del agente.
* **Contraseña**: La contraseña del agente.
* **Tag**: El equipo al que pertenece el agente. Debes seleccionar al menos un equipo.
* **Rol**: El rol del agente. Debes seleccionar el rol.
Finalmente, haz click en el botón **Crear** para confirmar la creación del agente.
## Cómo crear un equipo de agentes
Para poder crear un equipo de agentes, debes tener permisos de administrador.
Para crear un equipo de agentes, ve a la sección de **Agentes** en el panel izquierda de control de la plataforma de agentes. Allí podrás ver los equipos que tienes creados y crear uno nuevo.
Para crear un nuevo equipo (tag), haz click en el botón **Crear nuevo equipo**. Luego, en el campo de texto **tag** agrega el nombre del equipo. Por ejemplo, puedes agregar **ventas** o **soporte**.
Una vez que hayas creado el equipo, ya lo podrás ver en la lista de equipos en el bloque de transferencia a agente en el editor de conversaciones. Para ver este bloque, lee la sección de
.
En la sección de **Agentes**, puedes ver los agentes que tienes creados. Haz click en el botón **Editar** para asignarle un equipo. Puedes seleccionar varios equipos para un mismo agente. Ten en cuenta que si asignas varios equipos a un mismo agente, este agente podrá responder a las conversaciones de todos los equipos que le hayas asignado.
¡Has creado y configurado un equipo de agentes!
# Recomendaciones y preguntas frecuentes
Source: https://help.treble.ai/es/docs/agent-platform/admin/tips-and-questions
En esta sección, podrás encontrar recomendaciones y preguntas frecuentes sobre la plataforma de agentes de Treble.
# Recomendaciones importantes
Esto es fundamental por dos razones principales:
* Asegura que un nuevo chat sea asignado a un agente que realmente esté disponible para atenderlo
* Permite que las métricas de "tiempos de primera respuesta" y otras relacionadas con el rendimiento de tus agentes sean más precisas y reflejen la realidad operativa
Es importante finalizar los chats por los siguientes motivos:
* Si un usuario (cliente) tiene una sesión iniciada con un agente, no recibirá un nuevo mensaje ya que estará "atascado" en un chat anterior
* Solo los chats que son finalizados te permitirán acceder al historial completo de la conversación, lo cual es esencial para análisis posteriores y seguimiento
## Preguntas frecuentes
Puedes hacerlo desde [app.treble.ai](http://app.treble.ai/) entrando por Configuración > Conversaciones > Encuesta de satisfacción. Allí encontrarás la opción de "No enviar ningún mensaje" o se puede configurar el mensaje de preferencia.
**Ejemplo:** Un usuario escribe a las 12 de la noche, en ese momento no hay ningún agente activo. Al otro día a las 9am un agente se conecta y en ese momento se asigna el chat.
* El tiempo "primera respuesta de creación" es 9:01 am (desde que el usuario escribió hasta que el agente respondió).
* El tiempo "primera respuesta de asignación" es 1 minuto (desde que se le asignó el chat al agente hasta que respondió).
Sí, siempre y cuando no tenga chats abiertos.
Cuando un agente deja la compañía, puedes reutilizar su correo para un nuevo agente. Sin embargo, es importante primero asegurarte de que el agente anterior no tenga chats abiertos y que haya sido debidamente desactivado del sistema.
Sí, solo los perfiles con permisos de administrador pueden hacerlo.
No, debes solicitar acceso a través del portal de servicio en: [https://support-treble.atlassian.net/servicedesk/customer/portal/1/group/1](https://support-treble.atlassian.net/servicedesk/customer/portal/1/group/1)
Al forzar la transferencia de un chat, debes tener en cuenta:
* Asegúrate de que el agente destinatario esté activo y disponible para recibir el chat
* Comunica al usuario que será atendido por otro agente para evitar confusiones
* Comparte el contexto relevante con el nuevo agente para garantizar una transición fluida
* Considera el impacto en las métricas de ambos agentes
# IA - Asistentes Inteligentes
Source: https://help.treble.ai/es/docs/agent-platform/admin/treble-boost
Treble Boost es una IA que te permite crear asistentes inteligentes para tus conversaciones de ventas. Al crear un asistente inteligente, puedes definir el comportamiento de la IA, como el tipo de conversación, el idioma, el tono, etc. Esto le permite a tus agentes responder a las conversaciones de tus clientes de manera más eficiente.
# ¿Qué es Treble Boost?
Treble Boost es una de nuestras funcionalidades más recientes de inteligencia artificial, desarrollada para transformar y agilizar las interacciones de marketing y ventas en WhatsApp. Es nuestra solución para las crecientes necesidades de los profesionales de marketing y ventas que buscan optimizar sus procesos y mejorar la eficiencia en sus operaciones diarias, permitiendo un contacto más eficaz con sus clientes.
Los agentes pueden recibir sugerencias de mensajes directamente en el chat para responder preguntas complejas en segundos, basadas en información personalizada en formatos PDF, CSV o texto plano. Esto garantiza respuestas rápidas y precisas, aumentando la coherencia de la marca y la eficiencia en cada interacción.
**Resumen con IA:**
Además de enviar respuestas rápidas y completas, también existe la posibilidad de obtener resúmenes instantáneos y precisos de las conversaciones para tener contexto inmediato. Estos resúmenes se muestran en la sección de notas de la plataforma de ventas y en HubSpot, evitando preguntas repetidas, ahorrando tiempo y mejorando la experiencia del cliente.
**Transcripción de Audio a Texto con IA:**
Transcribe mensajes de audio a texto con un solo clic, permitiendo que los agentes de ventas lean las transcripciones y gestionen los audios de manera más eficiente. Esto resulta en respuestas más rápidas a los clientes y una mejor gestión del tiempo.
## ¿Cuáles son las ventajas de usar Treble Boost?
**✨Responde más rápido a los clientes:** Con resúmenes generados por IA y transcripción de audios a texto, tus agentes pueden gestionar múltiples conversaciones con mucha más eficiencia.
**✨Optimiza tu tiempo:** Permite que tus equipos se concentren en tareas de mayor valor mientras la IA se encarga de las interacciones repetitivas.
**✨Haz menos, hazlo mejor:** Optimiza tu tiempo y esfuerzo en las áreas de marketing y ventas.
**✨Consistencia y precisión:** Asegura que tus mensajes mantengan la coherencia de la marca y transmitan información precisa en todo momento.
# ¿Cómo crear y activar un asistente?
Ahora que entiendes qué es Treble Boost y cuáles son sus ventajas, te enseñaremos a crear y activar un asistente para mejorar tus atenciones.
1. Abre la plataforma [sales.treble.ai](http://sales.treble.ai/) y haz clic en "Asistentes".
Aquí puedes ver la lista de todos los asistentes que has creado y también crear nuevos.
2. Para crear un nuevo asistente, haz clic en **+ Nuevo asistente**.
Completa la siguiente información para que el asistente esté listo para usarse en las conversaciones:
* **Nombre del asistente:** Ayuda a los agentes a identificar cuál seleccionar al responder el chat; elige un nombre claro y fácil de identificar.
* **Conocimiento:** Proporciona al asistente la información necesaria subiendo hasta 3 documentos con el contenido que debe conocer. Asegúrate de que los documentos sean detallados y de dominio público.
* **Instrucciones:** Responde a 5 preguntas sobre tu asistente de manera detallada y clara:
1. **Objetivo del asistente:**
Define claramente el propósito del asistente.
2. **Producto, servicio o empresa que representa:**
Especifica qué ofrece el asistente.
3. **Tono de respuesta:**
Describe las características de personalidad del asistente, por ejemplo: serio, formal, amigable, didáctico.
4. **Número máximo de caracteres:**
Define la extensión de las respuestas del asistente, considerando que WhatsApp es una plataforma de comunicación rápida.
5. **Comportamiento ante preguntas desconocidas:**
Establece cómo debe actuar el asistente cuando no conozca la respuesta.
* **Equipos:** Define qué equipos pueden acceder a este asistente y proporciona instrucciones de uso para ellos.
* Haz clic en "Crear asistente" y estará listo para usarse.
En este ejemplo, el asistente está diseñado para responder dudas sobre los cursos de una universidad.
# ¿Cómo activar un asistente?
Una vez creado el asistente, sigue estos pasos para activarlo:
1. Abre la conversación donde deseas usar el asistente.
2. Selecciona la opción ✨Boost.
3. Elige el asistente deseado, espera que genere la respuesta y envíala en segundos.
Además de generar respuestas rápidas y completas, **Treble Boost** también te permite crear un **resumen objetivo y completo** de la conversación. Para generar el resumen, haz clic en el botón ✨**Resumen**.
Al integrar inteligencia artificial en las interacciones diarias, es posible garantizar **respuestas más rápidas, personalizadas y coherentes**, reduciendo el esfuerzo manual y aumentando la productividad de los equipos.
Con funcionalidades como **sugerencia de mensajes, resúmenes automáticos y transcripción de audios**, tu equipo gana tiempo, eficiencia y calidad en la atención, sin perder la humanización ni el tono adecuado para cada conversación.
**Treble Boost** es un **aliado estratégico** para quienes buscan escalar resultados con inteligencia, agilidad y foco en el cliente. Ahora que ya conoces todas las ventajas y has aprendido cómo crear y activar tu asistente, el próximo paso es simple: poner todo en práctica y transformar tus atenciones con ayuda de la IA.
Haz clic [aquí](https://trebleai.navattic.com/treble-boost) para ver un poco más de Treble Boost en acción. Si tienes alguna duda, no olvides contactar a tu CSM.
# Sección de contactos
Source: https://help.treble.ai/es/docs/agent-platform/contacts
Aprende a sacar el máximo provecho de esta sección. Aprende cómo agregar contactos, iniciar una nueva conversación o consultar el histórico de una conversación pasada.
### Cómo crear un nuevo contacto
1. Debes entrar en la sección de contactos (que encuentras en el panel izquierdo).
2. Luego debes dar click en el botón agregar contacto y llenar los datos como su nombre y número de teléfono.
3. Finalmente, debes dar click en agregar contacto, y listo.
### Cómo buscar un contacto
1. A la derecha del botón de agregar contacto, se encuentra el botón de búsqueda, donde se puede un buscar un contacto por nombre o número de teléfono.
### Cómo ver eventos del historial de la conversación
El historial de conversación completo tiene ahora una vista general a la derecha de la pantalla. Ahí podrás encontrar todo el histórico de ese contacto como un scroll infinito.
Si quieres acceder sólo a un fragmento de una conversación, puedes usar los eventos como referencia y luego dar click en **ver conversación y notas** para ver sólo lo correspondiente a ese evento.
Hay casos donde un mismo contacto ha hablado con diferentes lineas de la empresa. El historial de conversación está dividido por lineas de WhatsApp. Si tu cuentas con más de una línea, es importante seleccionar el contacto y la línea correspondiente al historial que quieres ver.
Una vez estés dentro del histórico perteneciente a una linea puedes cambiar dando clic en el desplegable
### Como iniciar una conversación desde un contacto
Una vez dentro de un contacto, el proceso de iniciar una conversación dependerá del estado de la misma.
Dentro de [sales.treble.ai](http://sales.treble.ai) es posible tener tres estados de conversación:
1. **Activa:** Esta conversación está actualmente asignada a un agente y con la ventana de WhatsApp abierta para el intercambio abierto de mensajes.
2. **Inactiva:** Esta conversación está actuallmente asignada a un agente pero con la ventana de WhatsApp cerrada. Lo que no permite el intercambio de mensajes que no sean una plantilla HSM hasta que se vuelva a abrir.
3. **Finalizada:** Esta conversación ha sido cerrada por un agente y no hay ninguna sesión de WhatsApp o treble. Para intercambiar mensajes se debe enviar una plantilla HSM.
Dependiendo del estado de la conversación, tendrás las siguientes opciones dentro de la vista de contactos.
1. **Activa/Inactiva:** Para este tipo de conversaciones tendrás un link de acceso directo al chat para retomar la conversación desde la vista de chats
2. **Finalizada:** Para este tipo de conversaciones podrás enviar una plantilla HSM desde la vista de contactos.
# Cómo ordenar y filtrar conversaciones
Source: https://help.treble.ai/es/docs/agent-platform/filters
Aprende a usar la vista de chats de treble.ai para trabajar con foco, dar seguimiento y no dejar pasar ninguna conversación importante.
La vista de chats en treble.ai está diseñada para ayudarte a priorizar lo importante: responder a quienes más lo necesitan. Ya sea que estés atendiendo decenas o cientos de conversaciones al día, esta herramienta te permite encontrar rápidamente los chats correctos y tomar acción sin perder tiempo.
Con opciones para buscar, ordenar y filtrar conversaciones —además de separar las activas de las inactivas— puedes trabajar con enfoque, mantener tu bandeja limpio y asegurar un buen seguimiento.
## Conversaciones activas e inactivas
En la parte superior de la vista de chats verás dos pestañas:
* **Activos**: conversaciones que tienen una ventana de chat de WhatsApp activa. En este tab podrás encontrar todas las conversaciones que estás manejando.
* **Inactivos**: conversaciones que tienen una ventana vencida y no se han finalizado. Acá podrás identificar si hay conversaciones sobre las que necesitas retomar contacto enviando un HSM.
## Buscar conversaciones
La barra de búsqueda te permite encontrar rápidamente una conversación específica.
Puedes escribir:
* El **nombre del contacto**.
* Una **palabra o frase** que aparezca en los mensajes.
Ideal para cuando necesitas ir a un dato específico una conversación sin perder tiempo navegando manualmente.
## Ordenar conversaciones
Puedes ordenar las conversaciones para que las más relevantes aparezcan primero según tus prioridades.
### Opciones de ordenamiento
**Basado en:**
* **Último mensaje**: se toma en cuenta el último mensaje recibido o enviado.
* **Fecha de creación**: se toma en cuenta cuándo inició la sesión de chat.
**Orden:**
* **Recientes**: primero las conversaciones más nuevas.
* **Antiguas**: primero las más viejas.
### 💡 Ejemplos prácticos
**Objetivo:** Ver los mensajes más recientes que te han llegado
**Configuración:**
* **Basado en:** Último mensaje
* **Orden:** Recientes primero
Perfecto para mantenerte al día con las conversaciones más activas
**Objetivo:** Atender clientes que llevan más tiempo esperando
**Configuración:**
* **Basado en:** Fecha de creación
* **Orden:** Antiguas primero
Ideal para dar prioridad a quienes escribieron primero
**Objetivo:** Revisar los últimos chats abiertos hoy
**Configuración:**
* **Basado en:** Fecha de creación
* **Orden:** Recientes primero
Útil para revisar la actividad del día
## Filtrar conversaciones
Los filtros te permiten afinar tu vista para enfocarte en tipos de conversaciones específicas. Puedes aplicar múltiples filtros a la vez.
### Filtros disponibles
Filtra conversaciones por cuándo ocurrieron:
* **Hoy** - Solo conversaciones de hoy
* **Ayer** - Conversaciones de ayer
* **Últimos 7 días** - Actividad de la semana
* **Últimas 2 semanas** - Actividad quincenal
* **Último mes** - Actividad mensual
* **Últimos 3 meses** - Actividad trimestral
* **Último año** - Actividad anual
Los rangos de fecha se basan en la actividad más reciente de cada conversación
Filtra por el estado de la conversación:
Sin filtro adicional - muestra todas las conversaciones
Mensajes que aún no has abierto o revisado
El cliente escribió y tú aún no has respondido
Tú escribiste último, pero el cliente no ha respondido
Filtra por etiquetas específicas:
Puedes seleccionar **una o varias etiquetas** para enfocarte en:
* Campañas específicas
* Segmentos de clientes
* Casos especiales
* Productos o servicios
Combina múltiples etiquetas para crear vistas muy específicas de tus conversaciones
## Combinaciones útiles de filtros y orden
A continuación te compartimos configuraciones recomendadas para casos comunes:
**Filtros:** `Fecha = Hoy` + `Tipo = No leídos`
Perfecto para empezar el día revisando mensajes nuevos.
**Orden:** `Último mensaje + Recientes primero`
Atiende primero a quienes escribieron más recientemente.
**Filtros:** `Tipo = Seguimiento` + `Fecha = Hoy o Ayer`
Aprovecha la ventana de WhatsApp para reactivar conversaciones.
**Filtros:** `Tipo = Pendientes de respuesta` + `Fecha = Últimos 7 días`
Revisa qué conversaciones necesitan tu atención esta semana.
**Filtros:** `Tipo = Pendientes de respuesta` + `Tag = Coco`
Enfócate en una campaña específica que requiere respuesta.
**Filtros:** `Tags = Redes Sociales, Sitio Web`
Compara el rendimiento de diferentes campañas.
**Tab:** `Inactivas` + **Orden:** `Fecha de creación + Antiguas primero`
Identifica conversaciones que puedes finalizar para que todo el histórico viaje a HubSpot.
Puedes usar filtros y orden juntos para tener una vista muy específica y enfocada.
💡 **Ejemplo práctico:**
**"Quiero ver los chats etiquetados como 'Audi' o 'BMW', que están en pendientes de respuesta, y ordenarlos por la persona que me contactó primero."**
* Tags: Audi + BMW
* Tipo: Seguimiento
* Orden: Fecha de creación + Antiguas primero
Así aseguras que ninguna conversación importante se te escape, puedes trabajar con mayor claridad y reducir tus tiempos de respuesta.
# Detección automática de inactividad
Source: https://help.treble.ai/es/docs/agent-platform/inactivity
Configura Treble para detectar automáticamente cuando un agente deja de responder y marcarlo como inactivo, evitando que conversaciones queden sin atención.
## ¿Para qué sirve?
Cuando un agente se aleja de su computadora sin marcarse como inactivo, las conversaciones nuevas siguen asignándosele aunque no esté disponible para responder. La detección automática de inactividad resuelve esto: si un agente no interactúa con ninguna conversación durante el tiempo que configures, Treble le enviará una notificación de alerta dentro de la plataforma. Si el agente no responde a esa notificación, el sistema lo marcará como inactivo automáticamente.
Esta funcionalidad solo detecta inactividad mientras el agente tenga la pestaña de Treble Sales abierta en el navegador. Si el agente cierra la pestaña o el navegador sin cerrar sesión, su estado no cambiará. Capacita a tus agentes para que cierren sesión manualmente al terminar su turno.
## Cómo activarla
### Paso 1 — Ir a Configuración
Desde el menú lateral de Treble Sales, haz clic en **Configuración**.
### Paso 2 — Activar la detección de inactividad
Dentro de **Configuración → Agentes**, activa el switch **Detección automática de inactividad**.
Una vez activado, el sistema comenzará a monitorear la actividad de todos los agentes en tiempo real.
### Paso 3 — Configurar el tiempo de inactividad
Debajo del switch aparecerá el campo **Tiempo de inactividad (minutos)**. Define cuántos minutos de inactividad deben pasar antes de que el agente reciba la notificación y sea desconectado automáticamente.
Empieza con un valor de 20 minutos o más. Si el tiempo es demasiado corto, agentes que estén en medio de una conversación larga podrán ser desconectados incorrectamente. Ajústalo una vez que conozcas los patrones reales de tu equipo.
### Paso 4 — Así se ve la notificación para el agente
Cuando un agente supera el tiempo configurado sin interactuar, verá esta alerta dentro de la plataforma:
El modal muestra cuánto tiempo lleva el agente sin actividad registrada y una cuenta regresiva hasta que el sistema lo cambie a estado offline automáticamente. El agente tiene tres opciones:
* **Seguir en línea** — confirma que sigue activo, el contador se reinicia y continúa recibiendo conversaciones con normalidad.
* **Ir offline ahora** — se marca como inactivo de inmediato, sin esperar a que termine la cuenta regresiva.
* **No responder** — cuando la cuenta regresiva llega a cero, Treble lo marca como inactivo automáticamente y deja de asignarle conversaciones nuevas.
## Consideraciones importantes
* **El switch aplica para toda la cuenta.** No es posible configurar tiempos distintos por agente o grupo. Si tu equipo tiene roles con ritmos de trabajo muy diferentes, configura el timer según el segmento más lento y capacita a los demás para marcarse inactivos manualmente cuando sea necesario.
* **Sin historial de notificaciones.** Actualmente no existe un registro de cuántas veces se le envió una alerta a cada agente. Esta visibilidad está en el roadmap de la plataforma.
* **Comunícalo a tu equipo antes de activarlo.** Los agentes que no sepan qué es esta notificación pueden confundirse la primera vez que la vean. Explícales que si la reciben y están activos, solo deben hacer clic para confirmar.
## Próximos pasos
Conoce todas las funcionalidades disponibles para tu equipo de agentes.
Asegúrate de que tus agentes reciban alertas en tiempo real.
# Vista Principal
Source: https://help.treble.ai/es/docs/agent-platform/main-platform
Aprendamos a usar la vista principal de Treble para responder conversaciones como agente y algunas de las herramientas que puedes usar.
## Secciones de la Vista Principal
Cuando ingreses por primera vez a la plataforma, verás la vista principal. Esta vista está dividida en 3 secciones: vista de conversaciones entrantes, vista para responder las conversaciones y un panel a la derecha con información de la cuenta. Entendamos el funcionamiento de cada sección.
### Vista de Conversaciones Entrantes
En esta vista, verás todas las conversaciones entrantes que tienes en la plataforma. Si has usado plataformas como WhatsApp Web o herramientas de tickecting, verás las conversaciones que has recibido.
Como agente, empezarás a recibir conversaciones entrantes. Al hacer clic en una conversación, verás el historial de la conversación y podrás responderla.
#### Estado Activo de un Agente
Un punto importante es que como agente, solo podrás ver las conversaciones entrantes si tu estado es activo. Si tu estado es inactivo, no se te asignarán nuevas conversaciones.
Para cambiar tu estado, puedes hacerlo en el panel de configuración a la izquierda, debes hacer click en el icono de tu perfil y luego hacer click a **Cambiar a activo**. Sabrás que estás activo cuando veas el icono de tu perfil en color verde.
De igual manera, puedes cambiar tu estado a inactivo si haces click en el icono de tu perfil y luego haces click a **Cambiar a inactivo**.
Cerrar el tab, cerrar la sesión o cerrar la ventana de tu navegador, no hará que tu estado vuelva a inactivo. Para eso, debes hacer click en el icono de tu perfil y luego haces click a **Cambiar a inactivo**.
Si tu agente no cambia su estado a inactivo, seguirá recibiendo conversaciones entrantes.
Es importante mencionar que como agente solo podrás recibir conversaciones si perteneces a un equipo y la conversación es para tu equipo. Si no perteneces a un equipo, o perteneces a un equipo pero la conversación no es para tu equipo, no podrás ver la conversación.
Adicionalmente, puedes ordernar las conversaciones entrantes por los siguientes criterios:
* Último mensaje enviado
* Último mensaje por cliente
* Conversaciones nuevas
* Conversaciones transferidas
* Color de etiqueta
Para buscar una conversación, puedes usar el campo de búsqueda en la parte superior. También puedes usar el campo de búsqueda para buscar una conversación por el número de teléfono del cliente.
### Vista para Responder las Conversaciones
Al hacer click en una conversación entrante, verás la vista para responder la conversación. En esta vista, verás el historial de la conversación y podrás responderla. Esta vista refleja el historial de la conversación en tiempo real. Incluso encontrarás los recibos de lectura y recepción de mensajes los mensajes de WhatsApp.
En el panel superior verás (de izquierda a derecha):
* El nombre del cliente. Este podrá ser el nombre que el cliente tiene en su cuenta de WhatsApp o verás el número de teléfono del cliente.
* Duración de la sesión: Los chats solo se pueden mantener abiertos por 24 horas. Si el cliente no responde en ese tiempo, el chat se cerrará y no podrás responder.
* Función de inteligencia artificial para generar un resumen de la conversación. Tu agente puede usar esta función para generar un resumen de la conversación.
* Botón para finalizar la conversación con el cliente.
* Botón para editar información del cliente.
* Botón para agregar una etiqueta a la conversación.
* Botón para transferir la conversación a otro agente.
### Panel de Información de la Cuenta
En el panel de información de la cuenta, verás información adicional de la conversación. Aqui puedes encontrar **Información del contacto**, **Plantillas de respuesta rápida** y **Archivos y documentos adjuntos**.
## Transferir Conversaciones
Ofrece una experiencia más fluida a tu cliente, transfiriendo los chats a otros departamentos o agentes.
### ¿Por qué es importante dominar la transferencia de conversaciones?
En ocasiones, nuestros clientes nos contactan para tratar un asunto específico, pero pueden seleccionar una opción incorrecta en el árbol de decisiones o interpretar las opciones disponibles de manera diferente a lo pretendido.
Otra situación importante es cuando necesitas cambiar tu estado a inactivo en la plataforma, siendo necesario transferir la conversación a un compañero que continuará con la atención al cliente.
### ¿Cómo transferir una conversación?
Para transferir una conversación, haz clic en el ícono de dos flechas ubicado en la esquina superior izquierda de la página, en el menú superior.
A continuación, la herramienta te preguntará si deseas transferir a un grupo de agentes o a un agente específico.
Al transferir a un grupo, es importante conocer la regla de asignación de conversaciones configurada. Cuando diriges un chat a un grupo en lugar de a un agente específico, Treble utiliza la regla definida por el administrador para determinar qué miembro del grupo recibirá la conversación.
Al elegir a qué agente deseas transferir el chat, la herramienta también preguntará a qué grupo pertenece. Esto ocurre porque un agente puede estar en más de un grupo, y necesitamos definir a qué cola de este agente deseas transferir.
Ejemplo: El agente Lucas recibe conversaciones de los grupos de Ventas y Soporte. Al transferir una conversación a él, necesitarás especificar a través de qué grupo deseas hacer la asignación.
**¡Felicidades! Después de seleccionar el agente y hacer clic en transferir, la conversación aparecerá en la bandeja de entrada del nuevo agente.**
Cuando recibes una conversación transferida, es posible ver qué agente realizó la transferencia.
## Etiquetas de la Conversación
Las etiquetas son una forma de categorizar las conversaciones. Puedes agregar etiquetas a las conversaciones para que puedas organizarlas y buscarlas más fácilmente.
En [Treble.ai](http://Treble.ai), el uso estratégico de **etiquetas** se ha convertido en un elemento fundamental e indispensable para mejorar significativamente la **organización, priorización y análisis** de las diversas interacciones que ocurren diariamente entre agentes y clientes. Este sistema de categorización inteligente permite una gestión más eficiente y estructurada del flujo de comunicación, garantizando que cada interacción sea adecuadamente clasificada y gestionada.
### **¿Cómo funcionan las etiquetas en Treble.ai?**
[Treble.ai](http://Treble.ai) te permite añadir **etiquetas personalizadas** a las conversaciones, categorizando las atenciones según tus necesidades. Estas etiquetas ayudan a estructurar el flujo de trabajo y pueden utilizarse para:
* **Filtrar y localizar conversaciones rápidamente** dentro de la plataforma.
* **Realizar seguimiento del estado** de una atención (ejemplo: "Pendiente", "Resuelto", "Esperando respuesta").
* **Identificar patrones de comportamiento y necesidades de los clientes**.
### **Principales beneficios del uso de etiquetas en Treble.ai**
* **Organización y priorización**
Las etiquetas permiten que los agentes clasifiquen las conversaciones por **tipo de atención, urgencia o departamento**, facilitando la gestión y evitando que mensajes importantes queden sin respuesta.
* **Mejora en la comunicación interna**
Con etiquetas estandarizadas, los agentes pueden identificar rápidamente el contexto de la conversación y dar continuidad a la atención sin necesidad de leer todo el historial.
* **Generación de informes estratégicos**
[Treble.ai](http://Treble.ai) permite la extracción de datos basados en las etiquetas aplicadas, ayudando en el análisis de desempeño del equipo, identificación de cuellos de botella en la atención y mejora continua del proceso.
### **¿Cómo crear etiquetas para conversaciones?**
Es importante señalar que, aunque cualquier agente puede utilizar etiquetas, solo los administradores tienen permiso para crearlas, garantizando así la organización del sistema.
Para crearlas, el administrador debe acceder a la parte superior del chat, hacer clic en el icono de etiquetas e iniciar el proceso de creación. Podrá nombrar la etiqueta y elegir un color que represente la situación que busca señalizar.
### **Ejemplo de uso práctico de las etiquetas en Treble.ai**
Imagina que un cliente se pone en contacto con una duda sobre pagos. El agente puede aplicar la etiqueta **"Duda Financiera"** y, si es necesario, derivar al equipo financiero. Si la conversación necesita un seguimiento posterior, puede recibir la etiqueta **"Esperando Retorno"**, garantizando que ninguna atención quede perdida.
¡Atención! En [Treble.ai](http://Treble.ai), el uso de etiquetas hace que la atención sea **más ágil, eficiente y estratégica**, ayudando a los equipos a mantener una comunicación fluida y organizada. ¡Implementar un sistema estandarizado de etiquetas es una forma sencilla y poderosa de mejorar la experiencia del cliente y optimizar la operación de tu empresa! 💡
## Sesión de 24 horas de una conversación
Entiende el funcionamiento de las ventanas de 24 horas utilizadas en WhatsApp API.
### ¿Qué son las sesiones?
Las sesiones son ventanas de tiempo de **24 horas** que comienzan cuando un cliente envía un mensaje a través de WhatsApp Business API. Durante este período, la empresa **puede responder libremente al cliente**. La sesión se renueva por otras 24 horas cada vez que el cliente responde, permitiendo que las conversaciones puedan extenderse por varios días, siempre que haya interacción constante.
Sin embargo, si la empresa intenta responder **después de ese plazo**, WhatsApp **bloquea** el envío de mensajes normales. Esto sucede porque WhatsApp quiere evitar el SPAM y garantizar que las empresas se comuniquen de manera relevante.
### **¿Cómo continuar la conversación después de 24 horas?**
Si la ventana se ha cerrado y necesitas retomar el contacto, la única forma de enviar un mensaje es usando una **Plantilla de Mensaje (HSM)** aprobada por WhatsApp.
#### ¿Qué es una **Plantilla de Mensaje (HSM)**?
* Es un mensaje pre-aprobado por WhatsApp que puede ser utilizado para reabrir la conversación.
* Puede contener variables dinámicas (ej: nombre del cliente, fecha de programación).
* Puede ser categorizado como:
* **Transaccional** (ejemplo: "¡Tu pedido ha sido confirmado! 🚀")
* **Marketing** (ejemplo: "¡Tenemos una oferta especial para ti!")
### **Ejemplo práctico**
Imagina que un cliente se puso en contacto a las **10 de la mañana de ayer** y tu equipo respondió normalmente a lo largo del día. Sin embargo, hoy, **a las 12 del mediodía**, te das cuenta de que necesitas enviar un nuevo mensaje, pero la ventana ya se ha cerrado.
🔴 **Intento de envío de un mensaje normal → WhatsApp lo bloquea.**
✅ **Envío de una Plantilla de Mensaje aprobada → WhatsApp permite reabrir la conversación.**
Tan pronto como el cliente responda a la plantilla, se abre una **nueva ventana de 24 horas**, permitiendo conversaciones normales nuevamente.
### ¿Cómo seguir el estado de la sesión de una conversación?
En la parte superior del chat, encontrarás un reloj en cuenta regresiva. Muestra cuánto tiempo queda hasta el cierre de la sesión, iniciando en 23:59:59 y llegando hasta 00:00:00.
#### **¿Cómo mantener la conversación abierta?**
1. **Estimular respuestas del usuario**: Pedir alguna interacción para garantizar que la ventana permanezca abierta.
2. **Monitorear el tiempo de la sesión**: Implementar notificaciones internas para que los agentes sepan cuándo una sesión está cerca de expirar.
Si tu sesión expira, será necesario enviar una Plantilla de Mensaje (HSM) para retomar la conversación.
## Botón de Resumen de Conversación
En **Treble.ai**, la función **"Resumen"** permite que los agentes obtengan un **resumen automático de la conversación** con el cliente, generado por inteligencia artificial. Este recurso **facilita el seguimiento de atenciones pasadas**, garantizando que cualquier agente que interactúe con el cliente tenga acceso a la información esencial sin necesidad de leer toda la conversación anterior.
### **¿Cómo funciona el botón "Resumen"?**
El botón **"Resumen"** puede ser activado cada **10 minutos** y genera un **resumen automatizado de la conversación** en curso. Esta nota queda vinculada a la conversación y puede ser accedida por cualquier agente que atienda a ese cliente en el futuro.
Los principales usos de este recurso incluyen:
* **Registrar detalles importantes de la atención** sin esfuerzo manual.
* **Mantener un historial accesible y resumido** para cualquier agente.
* **Evitar preguntas repetitivas**, ya que el agente tendrá un contexto previo.
### **Principales beneficios del resumen automático**
#### **Mejora en la comunicación interna**
Todos los agentes pueden acceder a los resúmenes anteriores, garantizando que el cliente no necesite repetir información en nuevas atenciones.
#### **Aumento de la eficiencia en la atención**
Con un historial resumido, los agentes pueden **retomar la conversación rápidamente** sin necesidad de revisar largos historiales de mensajes.
#### **Registro estructurado para análisis**
Los resúmenes generados por IA facilitan el seguimiento de **patrones de atención**, ayudando a la empresa a entender mejor las necesidades de los clientes.
### **¿Cómo utilizar el resumen automático en Treble.ai?**
Simplemente haz clic en el botón **"Resumen"** para que la IA genere un resumen de la conversación. El agente puede escribir más información además de la que ya está presente en la nota, garantizando que el registro sea útil para futuras interacciones.
### **Ejemplo de uso práctico del resumen automático**
Si un cliente se pone en contacto para preguntar sobre precios y, días después, regresa para cerrar la compra, el nuevo agente puede visualizar el **resumen de la primera atención** y continuar la conversación de forma fluida, sin necesidad de rehacer preguntas innecesarias.
El botón "Resumen" en Treble.ai mejora la comunicación entre agentes, hace las atenciones más eficientes y garantiza que cada cliente reciba un servicio más ágil y personalizado.
# Aplicación Móvil para Agentes
Source: https://help.treble.ai/es/docs/agent-platform/mobile-app
Descubre la aplicación móvil de treble, una herramienta que permite mantener a tus agentes conectados y productivos en todo momento, garantizando una comunicación fluida y eficiente con los clientes desde cualquier lugar.
El Mobile App de treble es una aplicación que les permite buscar usuarios y contactos, visualizar el historial de mensajes, y enviar HSM a usuarios para iniciar conversaciones con valores personalizados. Al tener la aplicación en el celular, los agentes reciben notificaciones push cuando hay nuevos mensajes o conversaciones.
Tambien al recibir una respuesta, las conversaciones apareceran en la lista de chats. Se puede interactuar manera similar que la plataforma, enviando imágenes y archivos, que se pueden descargar o agregar desde el teléfono.
Además, permite transferir conversaciones a equipos o vendedores específicos, ordenar los mensajes según tus necesidades, y gestionar el estado activo o inactivo en la plataforma.
Es importante que los agentes tengan la aplicación instalada en su celular para poder interactuar con los clientes. Adicionalmente, es necesario que los agentes tengan una contraseña asignada para poder iniciar sesión en la aplicación.
# ¿Cómo descargar la aplicación de treble?
Puedes descargar la aplicación de treble desde la página
. Para instalarla, solo debes abrir esta página en el navegador de tu dispositivo móvil.
La instalación varía dependiendo de tu sistema operativo y navegador. A continuación, te mostramos los pasos para instalar treble:
### Para sistema iOS o navegador Safari:
1. Ingresa a
desde el navegador Google Chrome
2. Haz clic en el botón de compartir en la barra superior
3. Selecciona "Añadir a pantalla de inicio"
4. Nombra la app como
## ¿Qué funcionalidades están disponibles en la aplicación móvil de [treble.ai](http://treble.ai)?
El Mobile App de treble es una aplicación que les permite buscar usuarios y contactos, visualizar el historial de mensajes, y enviar HSM a usuarios para iniciar conversaciones con valores personalizados. Al tener la aplicación en el celular, los agentes reciben notificaciones push cuando hay nuevos mensajes o conversaciones.
Tambien al recibir una respuesta, las conversaciones apareceran en la lista de chats. Se puede interactuar manera similar que la plataforma, enviando imágenes y archivos, que se pueden descargar o agregar desde el teléfono.
Además, permite transferir conversaciones a equipos o vendedores específicos, ordenar los mensajes según tus necesidades, y gestionar el estado activo o inactivo en la plataforma.
Solo recibirás la notificación en tu móvil si no estás conectado a la plataforma de sales.treble.ai desde el ordenador u otro dispositivo
## Conclusión y próximos pasos
La aplicación móvil de treble representa una herramienta fundamental para mantener una comunicación efectiva y continua con los clientes. Su interfaz intuitiva y funcionalidades completas permiten a los agentes gestionar conversaciones de manera eficiente desde cualquier lugar.
Para comenzar a aprovechar todos los beneficios de la aplicación móvil de treble, te recomendamos:
1. Descargar e instalar la aplicación siguiendo los pasos mencionados anteriormente
2. Familiarizarte con las diferentes funcionalidades disponibles
3. Configurar las notificaciones push para mantenerte al día con las conversaciones
Si necesitas ayuda adicional o tienes preguntas sobre el uso de la aplicación, no dudes en contactar a nuestro equipo de soporte técnico.
# Configuración de Notificaciones Push
Source: https://help.treble.ai/es/docs/agent-platform/notifications
Activa las notificaciones push de la plataforma configurando tanto tu navegador como la configuración del sistema. Esta guía te ayudará a configurar correctamente las notificaciones en equipos de escritorio (Mac y Windows) y móviles (Android e iOS).
## ¿Por qué es útil?
Las notificaciones push permiten mantenerte informado en tiempo real sobre novedades en tus chats, incluso cuando no estás activamente dentro de la plataforma. Esto facilita una gestión más ágil y eficiente de tus tareas.
* Recibe alertas inmediatas ante nuevos chats o acciones que requieren tu atención.
* Mejora tus tiempos de respuesta sin necesidad de monitorear constantemente la plataforma.
## Requisitos Previos
Antes de comenzar, asegúrate de que:
* No estás usando una **ventana privada o de incógnito**
* Las **notificaciones están habilitadas** en el navegador y en la configuración del sistema
* El **modo No molestar** o **Concentración** está **desactivado**
* Tienes una **conexión a internet estable**
## Configuración en Escritorio
***
### Configuración del Navegador
Haz clic en el **ícono de información del sitio** en la barra de direcciones (puede aparecer como ícono de candado o controles deslizantes)
Asegúrate de que las notificaciones están encendidas dando click en el slider.
Eso es todo lo que debes hacer en tu navegador si usas Chrome.
Ve a **Safari > Configuración** (o **Preferencias** en versiones anteriores)
Navega a la pestaña **Sitios web**
Selecciona **Notificaciones** en el panel lateral izquierdo
Asegúrate de que sales.treble.ai esté configurada como **Permitir**
Si no aparece en la lista, activa la opción **"Permitir que los sitios web pidan permiso para enviar notificaciones"**
Al visitar la plataforma, haz clic en **Permitir** cuando el navegador te lo solicite
### Configuración del Sistema
Ve a **Configuración > Sistema > Notificaciones**
Verifica que las **Notificaciones** estén habilitadas a nivel general
Encuentra tu navegador (por ejemplo, **Chrome**) y asegúrate de que tenga permiso para enviar notificaciones
Ve a **Configuración > Sistema > Asistencia de concentración** y asegúrate de que esté en **Desactivado** o en **Solo prioridad**, con tu navegador incluido como remitente prioritario
Ve a **Configuración del sistema > Notificaciones**
Busca tu navegador (por ejemplo, **Chrome** o **Safari**) en la lista de apps. También es posible que te aparezca [sales.treble.ai](http://sales.treble.ai) si usas **Safari**
Asegúrate de que la opción **Permitir notificaciones** esté activada
Verifica que el modo **Concentración** esté desactivado en **Centro de control > Concentración**
## Configuración en Móvil
***
Ve a **Configuración > Aplicaciones y notificaciones > Chrome**
Toca **Notificaciones** y verifica que estén activadas
Asegúrate de que el modo **No molestar** esté desactivado en la configuración del dispositivo
Ve a **Configuración > Notificaciones**
Busca la opción de **Treble**. En caso de que tengas algún problema asegurate de configurar también las notificaciones del navegafor (**Safari o Chrome**).
Activa la opción **Permitir notificaciones**
Ve a **Configuración > Concentración** y verifica que **No molestar** o cualquier modo activo esté desactivado
## Solución de Problemas
Si después de seguir todos los pasos anteriores sigues sin recibir notificaciones:
* Prueba con otro navegador o dispositivo para aislar el problema
* Revisa nuevamente las configuraciones del sistema y del navegador
* Asegúrate de que tu dispositivo no esté en modo ahorro de batería o modo concentración
* Contacta al equipo de soporte para recibir ayuda personalizada
# Automatizaciones de SLA
Source: https://help.treble.ai/es/docs/agent-platform/sla-automations
Crea reglas que vigilan los tiempos de atención de tus conversaciones y ejecutan acciones automáticas cuando se supera un umbral: envía un mensaje, notifica por email o webhook, cambia el estado de un agente o inicia una conversación de Treble.
Las **Automatizaciones de SLA** te permiten definir reglas de nivel de servicio (SLA) sobre tus conversaciones. Cada regla vigila un tiempo de atención —por ejemplo, cuánto tarda un agente en dar la primera respuesta— y, cuando ese tiempo se **excede**, ejecuta una o más **acciones** automáticamente. Así puedes reaccionar a tiempo cuando una conversación se demora, sin tener que monitorearla manualmente.
Cada automatización se compone de dos partes:
* **Si se cumple** → la **condición**: el tiempo que se vigila y el umbral a partir del cual la regla se dispara.
* **Entonces** → la o las **acciones**: lo que Treble hace cuando la condición se cumple.
Cada regla se ejecuta **una sola vez por conversación**. Si la misma conversación vuelve a exceder el umbral más adelante, la regla no se dispara de nuevo para esa conversación.
***
## Paso a paso
Ingresa a **Configuración** en tu plataforma y selecciona la sección **Automatizaciones**.
Aquí verás la lista de automatizaciones existentes, ordenadas de la más reciente a la más
antigua.
Haz clic en el botón **Crear automatización** para comenzar.
Escribe un **nombre** que describa qué vigila la automatización (por ejemplo,
"Primera respuesta > 10 min") y haz clic en **Continuar**.
Selecciona una **plantilla** con un caso de uso ya armado o elige **Comenzar desde cero**
para configurar la condición y las acciones manualmente.
La automatización se arma en un lienzo con dos bloques: **Si se cumple** (la condición) y
**Entonces** (las acciones).
* **Condición**: define qué tiempo de la conversación se vigila y el **umbral** que lo dispara. Consulta [Condiciones](#condiciones).
* **Acciones**: lo que ocurre al superarse el umbral. Consulta [Acciones](#acciones).
Cuando termines, haz clic en **Guardar automatización**.
La automatización se guardará y podrás verla listada en la barra lateral izquierda.
¡Listo! Tu automatización de SLA está configurada y activa.
Puedes **activar o desactivar** cualquier automatización usando el interruptor que aparece
junto a su nombre en la barra lateral, sin necesidad de borrarla.
***
## Segmentar por tags
Al editar una automatización, puedes elegir que solo aplique a un subconjunto de tus
conversaciones seleccionando uno o varios **tags** de la lista disponible. La
automatización se disparará únicamente para las conversaciones que tengan al menos uno de
los tags seleccionados.
Si no seleccionas ningún tag, la automatización aplica a **todas** las conversaciones, sin importar sus tags.
***
## Ver historial de una automatización
Haz clic sobre una automatización en la barra lateral y luego en el botón **Ver historial**
para consultar todas las acciones que se han ejecutado hasta el momento.
En el historial solo aparecen las ejecuciones **posteriores a la activación de esta
funcionalidad**; no se muestran acciones anteriores. Además, cada ejecución se conserva
durante **90 días**, luego de los cuales se elimina del historial.
***
## Condiciones
La condición define **qué tiempo se vigila** y el **umbral** que lo dispara. Se lee como:
*"\[tiempo] **excede** \[valor] minutos/horas"*.
El umbral mínimo es de **5 minutos**.
| Condición | Qué mide | Se dispara cuando… |
| ------------------------------- | -------------------------------------------------------------------------------------- | -------------------------------------------------- |
| **Tiempo de primera respuesta** | El tiempo desde el primer mensaje del cliente hasta la primera respuesta de un agente. | Ningún agente respondió dentro del umbral. |
| **Tiempo de asignación** | El tiempo desde que entra la conversación hasta que se asigna a un agente. | La conversación no fue asignada dentro del umbral. |
| **Tiempo de resolución** | El tiempo desde que inicia la conversación hasta que se resuelve (se cierra). | La conversación no se resolvió dentro del umbral. |
| **Tiempo entre mensajes** | El tiempo transcurrido desde el último mensaje sin que haya respuesta. | Pasa el umbral sin un nuevo mensaje. |
| **Tiempo de cierre del chat** | Si la conversación se cerró antes del tiempo (umbral) que definas. | La conversación se cierra antes de ese tiempo. |
### Tiempo máximo aceptable
Además del umbral, puedes definir un **Tiempo máximo aceptable**. La regla solo aplica a
conversaciones **más recientes** que ese tiempo, para evitar que se dispare sobre
conversaciones antiguas en las que ya no tiene sentido intervenir.
***
## Acciones
Cuando la condición se cumple, Treble ejecuta las acciones que hayas configurado. Puedes
agregar **varias acciones** a una misma automatización con **Agregar acción**.
### Enviar mensaje automático
Envía un **mensaje de WhatsApp automático** al cliente en la conversación. Escribe el texto
en el campo **Mensaje**.
### Enviar alerta por email
Envía una **alerta por email** a la dirección que indiques en el campo **Email**. Útil para
notificar a un supervisor cuando un SLA se incumple.
### Enviar webhook
Hace una petición **POST** al endpoint que configures en **URL del endpoint**. Puedes dejarlo
**Sin autenticación** o agregar un **Token / API Key** que se enviará en el header
`Authorization`.
Este es el cuerpo (payload) que Treble envía cuando se incumple el SLA:
```json theme={null}
{
"event_id": "3f2a1c8e-9d44-4b17-8a55-6e1c0b7f2d31",
"timestamp": "2026-08-31T14:23:07Z",
"event_type": "SLA_BREACH",
"monitoring_type": "sla",
"company_id": 3,
"sla": {
"conversation_id": 10,
"rule_id": 4,
"rule_name": "SLA rule",
"condition_type": "assignation_time",
"threshold_seconds": 300,
"elapsed_seconds": 360.0,
"breached_at": 1700000000,
"contact_id": 512,
"contact_name": "Jane Doe",
"agent_id": 88,
"agent_email": "agent@company.com",
"language": "es",
"recipients": []
}
}
```
### Enviar conversación de Treble
Inicia una **conversación de Treble** (un flujo) con el cliente, por el **mismo número** en el
que ya tiene la conversación.
En el selector solo aparecen las conversaciones que son **push notification** y que **no
tienen variables por llenar**. Las conversaciones con variables no se pueden usar aquí
porque esas variables llegarían vacías. Si no hay ninguna que cumpla, el selector no aparece.
### Marcar agente activo
Cambia al **estado activo** al agente asignado a la conversación, para que vuelva a recibir
conversaciones.
### Marcar agente inactivo
Cambia al **estado inactivo** al agente asignado, para dejar de asignarle conversaciones nuevas.
### Actualizar propiedad de HubSpot
Actualiza una **propiedad del contacto en HubSpot** con el valor que definas. Elige la
propiedad en el campo **Propiedad** y escribe el valor que quieres asignarle en el campo
**Valor**.
***
## Consideraciones importantes
* **Se ejecuta una vez por conversación.** Una misma regla no se dispara dos veces para la misma conversación.
* **Activa/desactiva sin borrar.** Usa el interruptor de cada automatización en la lista para pausarla temporalmente.
* **Varias acciones por regla.** Puedes combinar, por ejemplo, un mensaje automático al cliente y una alerta por email al supervisor en la misma automatización.
* **Solo se detectan incumplimientos de las últimas 12 horas.** Treble revisa únicamente los incumplimientos de SLA ocurridos en las últimas 12 horas. Si una conversación incumple un SLA hace más de 12 horas, no será detectada.
***
## Conclusión y próximos pasos
Con las Automatizaciones de SLA puedes garantizar tiempos de atención consistentes y reaccionar
automáticamente cuando una conversación se demora, sin monitoreo manual.
Conoce todas las funcionalidades disponibles para tu equipo de agentes.
Marca agentes como inactivos automáticamente cuando dejan de responder.
# Entendiendo la plataforma de Agentes
Source: https://help.treble.ai/es/docs/agent-platform/welcome
En este artículo aprenderás los elementos más importantes de la plataforma de agentes de Treble, con el objetivo de que tú y tú equipo, saquen máximo provecho de la misma y logren una comunicación efectiva con tus clientes.
Sabemos que tus clientes son lo más importante para ti y queremos ayudarte a que logres una comunicación efectiva y organizada, además, queremos facilitar la vida de tus agentes ahorrando tiempo, atendiendo más volumen de chats sin perder la personalización, e incluso, poniendo a su disposición elementos como inteligencia artificial.
Te mostraremos cómo deberías usar la plataforma, cuáles son los tipos de perfiles que harán uso de la misma, cuáles son los features principales, y finalmente, compartiremos contigo algunas preguntas frecuentes y tips de uso.
# Plataforma de Agentes
La plataforma de agentes de Treble te permite a ti o tu equipo continuar tus conversaciones con tus clientes en WhatsApp. La plataforma se parece a WhatsApp Web, donde vas a ver las conversaciones entrantes de tus clientes pero tiene funcionalidades adicionales.
# ¿Cómo ingresar a la plataforma de agentes?
Cuando empiezas a usar Treble tendrás acceso a 2 plataformas principales: app.treble.ai y sales.treble.ai. Cuando hablamos de la plataforma de agentes, hablamos de sales.treble.ai , es aquí donde tú y tus agentes podrán gestionar los chats con sus clientes.
Puedes ingresar de 3 formas:
1. Directamente a la plataforma por el link sales.treble.ai
2. Si cuentas con la integración de Treble con HubSpot , puedes ingresar desde el dashboard de HubSpot: CRM -> Bandeja de entrada -> WhatsApp.
Solo podrás visualizar Treble en HS cuando hayas hecho la integración inicial y hayas descargado la extensión de Chrome como te indicamos aquí: Descargar la extensión de Chrome
3. Si cuentas con la integración de Treble con Salesforce , puedes ingresar desde la configuración de pestaña realizada en Salesforce.
# Tipos de Agentes
En Treble, existen 2 tipos de agentes:
## Vendedor o Agente
Un agente - vendedor solo podrá visualizar los chats y el idioma. y es fundamental que se ponga como "activo" para poder recibir los chats.
También es importante que cuando finalice su turno se ponga como inactivo, para que un nuevo chat entre a un agente que realmente esté disponible, y también para que luego las métricas de "tiempos de primera respuesta" y otras del performance de tus agentes sean más acertadas.
### Secciones de la plataforma de agentes
A continuación podrás ver cada sección en la plataforma de agentes:
1. Es el espacio en donde tus agentes podrán escribir los mensajes.
2. Treble Boost ✨: crea y entrena diferentes asistentes de inteligencia artificial para brindar respuestas adecuadas de manera eficiente.
Solo los usuarios administradores podrán crear estos asistentes.
3. ¡Agrega emojis! 🚀 Incluso si te mandan stickers podrás visualizarlos.
4. Selecciona este ícono para adjuntar archivos.
5. Escribe notas sobre esta conversación, bien sea para tu recordarlo luego, o para que otro agente acceda a la información. ¡No te preocupes! estas notas no las ve el cliente.
6. Envía mensajes HSM manualmente. Selecciona este ícono y elige el HSM que quieres enviar. Para conocer más sobre los mensajes HSM, puedes leer este artículo: ¿Qué son los mensajes HSM?
7. En este apartado podrás ver todas las conversaciones y a través de los tags filtrar por las activas o inactivas
Una conversación activa es aquella que tiene una ventana de WhatsApp (24hrs) abierta. Y una inactiva es aquella que ya se venció.
8. En esta sección podrás buscar, filtrar y ordenar tus conversaciones.
9. Usa este botón para seleccionar múltiples chats para hacer acciones en masa como finalizarlos o envíar HSMs para retomar conversaciones inactivas.
10. Genera resúmenes asistidos por Treble Boost para un seguimiento preciso de la interacción.
11. Finaliza un solo chat, el que está abierto.
12. Edita el nombre del contacto en Treble. Esta acción no implica cambios en la información de HubSpot.
13. ¡Agrega etiquetas por colores! Podrás marcar los chats con las etiquetas que requieras para visualizarlos de manera organizada y hacer marcaciones que sean importantes para ti.
Solo los usuarios administradores podrán crear etiquetas, y los usuarios vendedores podrán aprovecharlas.
14. Transfiere el chat a otro agente o grupo.
15. Recuerda que Meta nos brinda 24 horas para llevar a cabo una conversación con un cliente. Cuando el cliente nos escribe/responde, el tiempo vuelve a ponerse en 24 horas disponibles para tu agente responder.
16. Ve la información del contacto el HubSpot. Podrás visualizar nombre, teléfono, email y dueño del contacto.
17. Usa plantillas de respuesta rápida para ahorrar tiempo. Por ejemplo, un saludo, una oferta definida o los términos y condiciones de un negocio.
Las plantillas de respuesta rápida son diferentes a los mensajes HSM. Estos últimos son los high security message que Meta aprueba o no para abrir un chat con un cliente. Las plantillas solo pueden ser creadas por usuarios administradores y son mensajes pre-definidos para brindar respuestas más rápidas.
18. Revisa los archivos, documentos y notas de voz que han sido compartidas en este chat.
19. ¡Envía notas de voz! 🎤
20. Abre el contacto el HubSpot para más detalles.
## Administrador
Los administradores tienen acceso a todas las secciones de la plataforma de agentes. Además, pueden crear etiquetas, crear asistentes de Treble Boost, y ver todas las conversaciones. Lee la siguiente sección para conocer más sobre los administradores.
# Pruebas A/B
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/ab-test
Aprende a usar el bloque de Pruebas A/B en Treble
En Treble, la funcionalidad de pruebas A/B está diseñada específicamente para ayudarte a optimizar la comunicación con clientes y leads a través de WhatsApp, asegurando que cada mensaje, tono, campaña, y beneficio que envías esté perfectamente ajustado para obtener los mejores resultados posibles. Aquí te detallo cómo esta funcionalidad opera dentro de Treble y cómo puede ayudarte a mejorar tu estrategia de marketing.
## 🕵🏼♀️ Evaluación de Mensajes, Tonos, Campañas y Beneficios
Dentro de Treble, las pruebas A/B te permiten realizar comparaciones directas entre diferentes versiones de mensajes que envías a través de WhatsApp. Puedes experimentar con variaciones en:
* **El mensaje**: Cambiar la redacción para ver qué versión resuena mejor con tu audiencia.
* **El tono**: Probar un tono más formal frente a uno más casual para determinar cuál genera una mejor respuesta.
* **La campaña**: Comparar dos enfoques de campaña distintos para ver cuál es más efectivo en términos de conversión o engagement.
* **El beneficio**: Ofrecer diferentes incentivos o promociones y medir cuál tiene un mayor impacto en la decisión de compra.
Esta capacidad de prueba es crucial para identificar qué elementos de tu comunicación son más efectivos en capturar la atención y motivar la acción de tus leads y clientes.
## 💣 Identificación de Estrategias Efectivas
Treble te permite analizar los resultados de tus pruebas A/B, proporcionando datos claros sobre cuál de las opciones evaluadas está teniendo un mejor desempeño. Esta retroalimentación rápida te permite ajustar tu estrategia de manera ágil, maximizando la eficiencia de tus campañas.
Por ejemplo, si descubres que un cierto mensaje con un tono más informal genera un mayor engagement, puedes implementar esta estrategia de forma más amplia, asegurando que cada interacción futura sea más efectiva.
## 🧠 Enfoque en Objetivos Específicos
Una de las ventajas de realizar pruebas A/B en Treble es la capacidad de alinear tus experimentos con objetivos específicos. Ya sea que busques aumentar la tasa de respuesta, mejorar la retención de clientes o incrementar las ventas, Treble te permite diseñar pruebas que te acerquen más a tus metas.
Treble facilita la medición de diferentes métricas según lo que sea más importante para tu campaña, como tasas de apertura, clics en enlaces, respuestas directas o conversiones, brindándote una visión clara de lo que está funcionando y lo que no.
## 👏🏼 Automatización y Optimización Continua
Otra característica clave en Treble es la automatización en la optimización de campañas basadas en los resultados de las pruebas A/B. Una vez que se identifica una estrategia ganadora, Treble puede automatizar la implementación de esta en tus futuras campañas de WhatsApp, permitiéndote escalar rápidamente las mejores prácticas sin intervención manual constante.
## 🥁 Video Explicativo
# Transferencia a agente
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/agent
Aprende a usar el bloque de Transferencia a agente en Treble
Ahora existe el bloque de **Métodos de transferencia**, que reúne todos los métodos de asignación —Treble, HubSpot y API— en un solo bloque y te permite definir la lógica **por conversación** en lugar de una sola vez para toda la empresa. Este bloque sigue funcionando igual, pero te recomendamos usar el nuevo en tus flujos nuevos.
Define el método de asignación en cada punto de tu flujo: agente con menos chats, aleatorio, agente específico, propietario en HubSpot, equipo o tu propia API.
## Transferencia a agente
El bloque de transferencia a agente es una herramienta poderosa que te permite configurar tus flujos de Treble para decidir en qué partes de la conversación quieres continuar el chat con un asesor/agente de tu equipo. Agregar este bloque es muy sencillo y te permite ofrecer una atención personalizada y eficiente.
### ¿Cómo funciona?
Ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación".
Configura tu conversación con los bloques de mensajes que desees. Una vez quieras agregar el bloque de **Transferencia a agente** Haz click en el botón y selecciona el bloque de **Transferencia a agente**. Lo vas a encontrar en la sección de **Transferencia a humano** > **Transferencia a agente en Treble**. Agrega el bloque y conectalo con el bloque de mensaje que quieras.
Si esta es la primera vez que agregas este bloque, encontrarás que el bloque tiene seleccionado el equipo `DEFAULT`. Este equipo es el equipo de agentes por defecto que se creó cuando creaste tu cuenta de Treble. Sin embargo, puedes seleccionar otro equipo de agentes que ya tengas creado. Para hacer esto, has doble click en el bloque, esto desplegará un menú donde podrás seleccionar el equipo de agentes que desees.
Si utilizas workflows de HubSpot para asignación o etiquetado de propiedades, puedes configurar un retraso antes de que Treble asigne la conversación a un agente. Esto garantiza que los workflows de HubSpot estén sincronizados con Treble antes de la asignación.
Para configurar el retraso:
1. Haz doble click en el bloque de transferencia a agente
2. En el menú de configuración, busca la opción "Retraso de asignación"
3. Activa la opción y configura los minutos de espera (recomendado: 2-5 minutos)
¡Has creado y configurado una transferencia a agente!
## Configuración avanzada
Si utilizas HubSpot y tienes workflows de asignación o etiquetado de propiedades, la siguiente información te ayudará a configurar correctamente el retraso de asignación para evitar problemas de sincronización.
### ¿Por qué configurar un retraso?
Los workflows de HubSpot pueden tardar unos minutos en procesar y sincronizar datos con Treble. Sin un retraso configurado, Treble podría asignar una conversación a un agente diferente al definido en tu workflow de HubSpot.
**Ejemplo**: Si tu workflow de HubSpot asigna contactos a agentes específicos basado en propiedades como "Industria" o "Tamaño de empresa", sin el retraso configurado, Treble podría asignar la conversación antes de que HubSpot haya actualizado estas propiedades.
### Casos de uso habilitados
Con la sincronización correcta, puedes desbloquear funcionalidades avanzadas como:
* **Distribución round robin**: Utiliza la funcionalidad de rotar contactos de los workflows de HubSpot
* **Asignación basada en propiedades**: Asigna agentes según industria, tamaño de empresa, o cualquier propiedad personalizada
### Configuración flexible
El retraso se configura individualmente por bloque, no globalmente. Esto te da la flexibilidad de:
* Configurar atención rápida cuando no hay workflows de HubSpot involucrados
* Aplicar retrasos solo en conversaciones donde los workflows son necesarios
* Optimizar la experiencia del usuario según el contexto de cada conversación
## Dudas frecuentes
No te preocupes, puedes crear un equipo de agentes accediendo como administrador a la plataforma de agentes de Treble. Para conocer más sobre como crear un equipo de agentes, puedes leer nuestro artículo sobre [equipos de agentes](/es/docs/agent-platform/admin/tags-teams).
Las conversaciones transferidas a agentes no se ven en la herramienta principal de Treble. Sin embargo, puedes acceder a ellas desde la plataforma de agentes. Para conocer más sobre como acceder a la plataforma de agentes, puedes leer nuestro artículo sobre [plataforma de agentes](/es/docs/agent-platform/welcome).
Recomendamos configurar entre 2-5 minutos de retraso. Este tiempo es suficiente para que la mayoría de workflows de HubSpot se procesen y sincronicen con Treble. Puedes ajustar este tiempo según la complejidad de tus workflows.
No, el retraso solo afecta el momento de asignación al agente. El usuario puede seguir interactuando con el chatbot normalmente mientras Treble espera para hacer la asignación correcta.
# Bloque Condicional
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/conditional
El bloque condicional te permite tomar decisiones en función de las respuestas del usuario, variables nativas y variables personalizadas para dirigir el flujo de una conversación de Treble. Aprende a usar este bloque para crear flujos de conversación inteligentes y personalizados.
## ¿Qué es el bloque condicional?
El **bloque condicional** es uno de los bloques más poderosos de Treble. Te permite crear flujos de conversación inteligentes que toman decisiones automáticas basadas en las respuestas del usuario, variables nativas, variables personalizadas y propiedades de contactos de HubSpot.
Este bloque evalúa una condición y dirige el flujo de la conversación hacia diferentes caminos según si la condición es verdadera o falsa. Es fundamental para crear experiencias personalizadas y automatizar la toma de decisiones en tus conversaciones.
## Antes de empezar
Los bloques condicionales utilizan diferentes tipos de variables para evaluar las condiciones. Antes de empezar, asegúrate de que tienes claro cómo funcionan:
### Variables en Treble
Los bloques condicionales utilizan variables de Treble para evaluar las condiciones. Si no tienes claro cómo funcionan las variables, puedes leer nuestra guía sobre variables aquí:
Aprende a crear y usar variables personalizadas y recopiladas por el cliente.
### Variables nativas
Las variables nativas son variables especiales que el sistema provee automáticamente. Puedes usarlas directamente en bloques condicionales sin necesidad de haberlas capturado previamente:
Conoce las variables nativas disponibles en Treble.
### Variables de HubSpot (si usas la integración)
Si utilizas la integración con HubSpot, los bloques condicionales también pueden usar las propiedades de los contactos de HubSpot:
Aprende a usar las propiedades de HubSpot en tus bloques condicionales.
## ¿Dónde encontrar el bloque condicional?
Inicia sesión en Treble.ai en:
Dirígete a la sección **Conversaciones** y haz clic en **Crear nueva conversación** o edita una conversación existente.
Una vez en el editor de flujos, haz clic en el botón en el panel superior izquierdo para desplegar el menú de bloques.
Desplázate hacia abajo en el menú de bloques hasta encontrar la sección **Condiciones**. Verás el bloque **Condiciones** disponible para agregar a tu flujo.
Haz clic en el bloque **Condiciones** para agregarlo a tu flujo de conversación. El bloque aparecerá en el editor y podrás moverlo a la posición que desees.
## Configuración del bloque condicional
Una vez agregado el bloque condicional a tu flujo, haz doble clic en el bloque para abrir el panel de configuración en el lado izquierdo del editor.
En el panel de configuración, verás diferentes tipos de condiciones disponibles:
* **Condición personalizada**: Para evaluar variables de Treble, variables nativas o propiedades de HubSpot
* **Condición horaria**: Para configurar condiciones basadas en tiempo y horarios de negocio
Selecciona **Condición personalizada** para la mayoría de casos de uso.
En la sección **Establece condiciones**, configurarás tres elementos:
* **Variable**: La variable que quieres evaluar (ej: `edad`, `country_code`, `inbound`)
* **Operador**: El operador de comparación (ej: Igual a, Mayor a, Contiene)
* **Valor**: El valor con el que comparar (ej: `18`, `+57`, `Soporte`)
Si necesitas evaluar múltiples condiciones, haz clic en el botón **Agregar condición** para añadir más condiciones al mismo bloque.
## Operadores disponibles
Treble ofrece 8 operadores diferentes para evaluar condiciones:
| Operador | Descripción | Ejemplo |
| ------------------- | ------------------------------------------------------ | ---------------------------- |
| **Igual a** | Compara si el valor es exactamente igual | `edad = 18` |
| **Mayor a** | Compara si el valor es mayor | `edad > 18` |
| **Menor a** | Compara si el valor es menor | `edad < 18` |
| **Mayor o igual a** | Compara si el valor es mayor o igual | `edad >= 18` |
| **Menor o igual a** | Compara si el valor es menor o igual | `edad <= 18` |
| **Contiene** | Verifica si el valor contiene el texto especificado | `mensaje` contiene `ayuda` |
| **No contiene** | Verifica si el valor NO contiene el texto especificado | `mensaje` no contiene `spam` |
| **Diferente a** | Compara si el valor es diferente | `pais != Colombia` |
## Casos de uso con variables nativas
### Ejemplo 1: Redirigir según el país del usuario
**Objetivo**: Dirigir automáticamente al cliente con el agente que atiende su país de residencia.
**Configuración**:
* **Variable**: `country_code`
* **Operador**: Igual a
* **Valor**: `+57` (Colombia)
**Flujo**:
* Si `country_code` = `+57` → Agente de Colombia
* En todos los otros casos → Agente general
### Ejemplo 2: Horarios de atención
**Objetivo**: Mostrar diferentes mensajes según la hora del día.
**Configuración**:
* **Variable**: `time`
* **Operador**: Mayor o igual a
* **Valor**: `09:00`
**Flujo**:
* Si `time` >= `09:00` y `time` \< `18:00` → Mensaje de horario laboral
* En todos los otros casos → Mensaje de fuera de horario
### Ejemplo 3: Días de la semana
**Objetivo**: Ofrecer promociones solo los fines de semana.
**Configuración**:
* **Variable**: `weekday`
* **Operador**: Mayor o igual a
* **Valor**: `6` (Sábado)
**Flujo**:
* Si `weekday` >= `6` → Promoción de fin de semana
* En todos los otros casos → Mensaje regular
### Ejemplo 4: Palabras clave iniciales
**Objetivo**: Enrutar según la palabra clave con la que el usuario inicia la conversación.
**Configuración**:
* **Variable**: `inbound`
* **Operador**: Igual a
* **Valor**: `Soporte`
**Flujo**:
* Si `inbound` = `Soporte` → Flujo de soporte
* Si `inbound` = `Ventas` → Flujo de ventas
* Si `inbound` = `Cotización` → Flujo de cotizaciones
* En todos los otros casos → Menú general
## Casos de uso con variables personalizadas
### Ejemplo 1: Edad del cliente
**Objetivo**: Ofrecer diferentes productos según la edad del cliente.
**Configuración**:
* **Variable**: `edad_cliente`
* **Operador**: Mayor o igual a
* **Valor**: `18`
**Flujo**:
* Si `edad_cliente` >= `18` → Productos para adultos
* En todos los otros casos → Productos para menores
### Ejemplo 2: Tipo de problema
**Objetivo**: Dirigir a diferentes agentes según el tipo de problema reportado.
**Configuración**:
* **Variable**: `tipo_problema`
* **Operador**: Contiene
* **Valor**: `técnico`
**Flujo**:
* Si `tipo_problema` contiene `técnico` → Agente técnico
* Si `tipo_problema` contiene `facturación` → Agente de facturación
* En todos los otros casos → Agente general
## Condiciones compuestas
### Ejemplo 1: Múltiples condiciones en un bloque
Puedes agregar múltiples condiciones en el mismo bloque condicional:
**Configuración**:
* Condición 1: `country_code` = `+57`
* Condición 2: `time` >= `09:00`
* Condición 3: `time` \< `18:00`
**Resultado**: El flujo seguirá el camino "Sí" solo si TODAS las condiciones son verdaderas (usuario de Colombia Y en horario laboral).
### Ejemplo 2: Bloque condicional seguido de otro bloque condicional
Puedes encadenar múltiples bloques condicionales para crear flujos complejos:
**Flujo**:
1. Primer bloque condicional: ¿Es cliente de Colombia?
* Sí → Segundo bloque condicional: ¿Es horario laboral?
* Sí → Agente de Colombia en horario laboral
* No → Agente de Colombia fuera de horario
* No → Tercer bloque condicional: ¿Es horario laboral?
* Sí → Agente internacional en horario laboral
* No → Agente internacional fuera de horario
## Uso del "En todos los otros casos"
El **"En todos los otros casos"** es fundamental en los bloques condicionales. Define qué sucede cuando ninguna de las condiciones configuradas se cumple.
### Ejemplo práctico:
**Configuración**:
* Si `country_code` = `+57` → Agente de Colombia
* Si `country_code` = `+55` → Agente de Brasil
* **En todos los otros casos** → Agente internacional
**Importante**: Siempre debes conectar el **"En todos los otros casos"** a un bloque de mensaje o acción. Nunca dejes esta ruta sin conectar.
## Configuración de horarios y tiempo
Para configurar condiciones basadas en tiempo, puedes usar la **Condición horaria**:
Aprende a configurar horarios y tiempo en Treble.
### Ejemplo de configuración horaria:
**Configuración**:
* **Tipo**: Condición horaria
* **Zona horaria**: America/Bogota
* **Horario**: 09:00 - 18:00 (Lunes a Viernes)
**Flujo**:
* Si está en horario laboral → Agente regular
* En todos los otros casos → Mensaje de fuera de horario
## Mejores prácticas
### 1. Siempre conecta "En todos los otros casos"
Nunca dejes esta ruta sin conectar. Siempre debe llevar a un bloque de mensaje o acción.
### 2. Usa nombres descriptivos para las variables
En lugar de `var1`, usa nombres como `edad_cliente`, `tipo_problema`, `pais_usuario`.
### 3. Prueba tus condiciones
Antes de desplegar, verifica que tus condiciones funcionen correctamente con diferentes valores.
### 4. Mantén los flujos simples
Evita crear flujos demasiado complejos. Si tienes muchas condiciones, considera dividirlas en múltiples bloques.
### 5. Documenta tus decisiones
Usa comentarios en los bloques de mensaje para documentar por qué tomaste ciertas decisiones en el flujo.
## Solución de problemas comunes
### Problema: El bloque no funciona como esperaba
**Solución**: Verifica que:
* La variable existe y tiene el valor correcto
* El operador es el adecuado para el tipo de dato
* El valor de comparación está en el formato correcto
### Problema: Múltiples condiciones no funcionan
**Solución**: Recuerda que todas las condiciones deben cumplirse para que el flujo siga el camino "Sí". Si necesitas que solo una se cumpla, usa bloques condicionales separados.
### Problema: La condición horaria no funciona
**Solución**: Verifica que:
* La zona horaria está configurada correctamente
* Los horarios están en formato 24 horas
* Los días de la semana están configurados correctamente
## Ejemplos avanzados
### Ejemplo 1: Sistema de soporte inteligente
**Objetivo**: Crear un sistema que dirija automáticamente según el país, horario y tipo de problema.
**Flujo**:
1. Bloque condicional: ¿Es horario laboral?
* Sí → Bloque condicional: ¿Es cliente de Colombia?
* Sí → Agente de Colombia
* No → Agente internacional
* No → Mensaje de fuera de horario
### Ejemplo 2: Sistema de ventas personalizado
**Objetivo**: Ofrecer productos según la edad y país del cliente.
**Flujo**:
1. Bloque condicional: ¿Es mayor de edad?
* Sí → Bloque condicional: ¿Es cliente de Brasil?
* Sí → Productos para adultos en Brasil
* No → Productos para adultos internacionales
* No → Productos para menores
### Ejemplo 3: Router de conversaciones
**Objetivo**: Enrutar automáticamente según la palabra clave inicial.
**Flujo**:
1. Bloque condicional: ¿Cuál es la palabra clave inicial?
* Si `inbound` = `Soporte` → Flujo de soporte
* Si `inbound` = `Ventas` → Flujo de ventas
* Si `inbound` = `Facturación` → Flujo de facturación
* En todos los otros casos → Menú principal
¡Perfecto! Ahora conoces cómo usar el bloque condicional para crear flujos de conversación inteligentes y personalizados en Treble.
## Próximos pasos
Aprende a usar las variables nativas en tus bloques condicionales.
Aprende a configurar horarios y tiempo en tus conversaciones.
# Bloque Enlace a Conversación
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/jump-to-conversation
El bloque enlace a conversación te permite redirigir el flujo de una conversación a otra conversación de Treble. Esto es útil si tienes un flujo de mensajes que quieres que se realice entre varias conversaciones o si quieres que un cliente pueda continuar una conversación en otro flujo de conversación. Aprende a usar este bloque para crear flujos de conversación inteligentes y personalizados.
## ¿Qué es el bloque enlace a conversación?
El bloque enlace a conversación es un bloque que te permite redirigir el flujo de una conversación a otro flujo de conversación de Treble. Este bloque es útil para crear flujos de conversación más complejos y personalizados.
Ejemplos:
* **Flujo de ventas recurrente**: Si tienes un flujo de conversación donde el cliente puede realizar compras y es un proceso que se repite varias veces, puedes usar tener distintas conversaciones que cuando detectan que el cliente quiere realizar una compra, redirijan al flujo de ventas recurrente.
* **Flujo de conversación de enrutamiento**: Si has creado un flujo de conversación inbound, puedes comparar la variable nativa `inbound` con un valor para redirigir el flujo de conversación a otro flujo de conversación existente. Por ejemplo, puedes tener uno para ventas, otro para soporte, y un tercero para clientes frecuentes.
* **Enrutamiento de agentes**: Si tienes una configuración avanzada de agentes (por ejemplo, distintos equipos de agentes por dia se la semana y horarios), puedes crear una conversación que se encarga de administrar el enrutamiento de agentes y puedes usar el bloque enlace a conversación para redirigir a éste cuando el cliente quiera hablar con un agente.
## ¿Cómo usar el bloque enlace a conversación?
Para usar el bloque enlace a conversación, debes seguir los siguientes pasos:
Inicia sesión en Treble.ai en:
Dirígete a la sección **Conversaciones** y haz clic en **Crear nueva conversación** o edita una conversación existente.
Una vez en el editor de flujos, haz clic en el botón en el panel superior izquierdo para desplegar el menú de bloques.
Desplázate hacia abajo en el menú de bloques hasta encontrar la sección **Enlace a conversación**. Verás el bloque **Enlace a conversación** disponible para agregar a tu flujo. Has click en el bloque y arrastralo a la posición que desees en tu flujo de conversación.
Una vez agregado el bloque, automáticamente se te abrirá el panel de configuración del bloque a la izquierda.
Aqui puedes buscar y seleccionar la conversación a la que se redirigirá el flujo. Una vez encuentres la conversación, haz click en ella para seleccionarla. Puedes buscar por el `id` o el nombre de la conversación.
Una vez seleccionada la conversación, el bloque quedará nombrado con la conversación seleccionada.
¡Éxito! Ahora conoces cómo usar el bloque enlace a conversación para redirigir el flujo de una conversación a otra conversación de Treble
## Escenario básico: Enrutamiento con variable `inbound`
Supongamos que tienes una empresa que maneja diferentes tipos de solicitudes de clientes. En lugar de tener un solo flujo de conversación largo y complejo, decides crear flujos especializados para cada tipo de solicitud. Para esto, creas una **conversación de enrutamiento** que actúa como un router inteligente.
**Conversaciones que tienes creadas:**
* **Conversación de Ventas**: Maneja consultas de productos, cotizaciones y compras
* **Conversación de Soporte**: Maneja problemas técnicos y solicitudes de ayuda
* **Conversación de Facturación**: Maneja consultas sobre facturas, pagos y estados de cuenta
* **Conversación de Enrutamiento**: Determina a qué flujo dirigir al cliente
**Configuración del flujo de enrutamiento:**
1. **Bloque de mensaje inicial**: Mensaje de bienvenida
2. **Bloque condicional**: Evalúa la variable `inbound`
3. **Bloques de enlace a conversación**: Redirigen según la condición
**Configuración del bloque condicional:**
* **Variable**: `inbound`
* **Operador**: Igual a
* **Valor**: `Ventas`
**Flujo completo:**
* Si `inbound` = `Ventas` → Enlace a conversación de Ventas
* Si `inbound` = `Soporte` → Enlace a conversación de Soporte
* Si `inbound` = `Facturación` → Enlace a conversación de Facturación
* En todos los otros casos → Mensaje de ayuda con opciones
**Ventajas de este enfoque:**
* **Mantenimiento simplificado**: Cada flujo se puede actualizar independientemente
* **Análisis específico**: Puedes medir el rendimiento de cada tipo de conversación por separado
* **Escalabilidad**: Fácil agregar nuevos tipos de conversaciones sin afectar las existentes
* **Personalización**: Cada flujo puede tener su propio tono y estructura
## Ejemplo avanzado - conversación de enrutamiento con links de WhatsApp
## Escenario avanzado: Campañas de marketing con links de WhatsApp
En este ejemplo más complejo, tu empresa ejecuta múltiples campañas de marketing en diferentes canales (Facebook, Google Ads, LinkedIn, Email Marketing) y quieres medir el rendimiento de cada campaña mientras diriges automáticamente a los clientes al flujo más apropiado.
**Campañas activas:**
1. **Campaña Facebook - Productos Premium**: Link con mensaje `Productos Premium`
2. **Campaña Google Ads - Soporte Técnico**: Link con mensaje `Soporte Técnico`
3. **Campaña LinkedIn - Consultoría**: Link con mensaje `Consultoría`
4. **Email Marketing - Facturación**: Link con mensaje `Facturación`
**Conversaciones especializadas:**
* **Conversación Productos Premium**: Flujo de ventas para productos de alta gama
* **Conversación Soporte Técnico**: Flujo especializado en problemas técnicos
* **Conversación Consultoría**: Flujo para servicios de consultoría empresarial
* **Conversación Facturación**: Flujo para consultas de facturación y pagos
* **Conversación Router Avanzado**: Determina el flujo basado en la campaña
### Configuración del router avanzado
**Paso 1: Crear los links de WhatsApp**
Para cada campaña, creas un link de WhatsApp con un mensaje predefinido específico:
Aprende a crear y gestionar links de WhatsApp en Treble.
**Configuración de los links:**
| Campaña | Link de WhatsApp | Mensaje Predefinido | Conversación Destino |
| ----------------------------- | ------------------------------------------ | ------------------- | ------------------------------ |
| Facebook - Productos Premium | `wa.me/tu-numero?text=Productos%20Premium` | `Productos Premium` | Conversación Productos Premium |
| Google Ads - Soporte Técnico | `wa.me/tu-numero?text=Soporte%20Técnico` | `Soporte Técnico` | Conversación Soporte Técnico |
| LinkedIn - Consultoría | `wa.me/tu-numero?text=Consultoría` | `Consultoría` | Conversación Consultoría |
| Email Marketing - Facturación | `wa.me/tu-numero?text=Facturación` | `Facturación` | Conversación Facturación |
**Paso 2: Configurar el router avanzado**
El flujo de la **Conversación Router Avanzado** se configura así:
1. **Bloque de mensaje de bienvenida**:
```
¡Hola! Gracias por contactarnos. Te estamos dirigiendo al área más apropiada para ayudarte.
```
2. **Bloque condicional principal**: Evalúa la variable `inbound`
* **Variable**: `inbound`
* **Operador**: Igual a
* **Valor**: `Productos Premium`
3. **Bloques de enlace a conversación**: Uno para cada campaña
**Flujo del router:**
* Si `inbound` = `Productos Premium` → Enlace a conversación Productos Premium
* Si `inbound` = `Soporte Técnico` → Enlace a conversación Soporte Técnico
* Si `inbound` = `Consultoría` → Enlace a conversación Consultoría
* Si `inbound` = `Facturación` → Enlace a conversación Facturación
* En todos los otros casos → Mensaje de ayuda con menú de opciones
### Ventajas del enfoque avanzado
**1. Medición granular de campañas:**
* Puedes ver exactamente cuántos leads genera cada campaña
* Mides la conversión por canal de marketing
* Identificas qué campañas tienen mejor ROI
**2. Experiencia personalizada:**
* Cada cliente llega directamente al flujo más relevante
* Reduces la fricción en la conversación
* Mejoras la tasa de conversión
**3. Análisis avanzado:**
* Comparas el rendimiento de Facebook vs Google Ads vs LinkedIn
* Identificas qué tipo de mensaje genera más engagement
* Optimizas tu presupuesto de marketing
**4. Escalabilidad:**
* Fácil agregar nuevas campañas sin modificar flujos existentes
* Cada flujo especializado puede evolucionar independientemente
* Mantenimiento simplificado
### Ejemplo de métricas que obtienes
Con esta configuración, puedes obtener métricas como:
**Por campaña:**
* Facebook - Productos Premium: 150 clicks, 45 conversiones
* Google Ads - Soporte Técnico: 200 clicks, 80 conversiones
* LinkedIn - Consultoría: 75 clicks, 25 conversiones
* Email Marketing - Facturación: 300 clicks, 120 conversiones
**Por flujo de conversación:**
* Conversación Productos Premium: 45 leads, 15 ventas (33% conversión)
* Conversación Soporte Técnico: 80 leads, 60 resueltos (75% resolución)
* Conversación Consultoría: 25 leads, 8 consultas (32% conversión)
* Conversación Facturación: 120 leads, 100 resueltos (83% resolución)
### Configuración técnica detallada
**Paso 3: Configurar cada conversación especializada**
Cada conversación de destino debe estar optimizada para su propósito específico:
**Conversación Productos Premium:**
* Mensaje de bienvenida personalizado
* Catálogo de productos premium
* Opciones de contacto con vendedores especializados
* Información sobre garantías y servicios premium
**Conversación Soporte Técnico:**
* Diagnóstico inicial del problema
* Base de conocimientos integrada
* Escalamiento automático a agentes técnicos
* Sistema de tickets integrado
**Conversación Consultoría:**
* Evaluación de necesidades empresariales
* Portafolio de servicios de consultoría
* Calendario de citas integrado
* Información sobre casos de éxito
**Conversación Facturación:**
* Consulta de estado de facturas
* Opciones de pago disponibles
* Escalamiento a agentes de facturación
* Información sobre políticas de pago
### Mejores prácticas para el router avanzado
**1. Mensajes predefinidos claros:**
* Usa mensajes específicos y descriptivos
* Evita mensajes genéricos como "Hola" o "Información"
* Incluye palabras clave que identifiquen claramente la intención
**2. Flujos de conversación optimizados:**
* Cada flujo debe estar diseñado específicamente para su propósito
* Incluye información relevante y opciones apropiadas
* Mantén un tono consistente con la campaña original
**3. Medición y análisis:**
* Revisa regularmente las métricas de cada campaña
* Identifica patrones en el comportamiento de los usuarios
* Optimiza los flujos basándote en los datos
**4. Escalabilidad:**
* Diseña el router para manejar futuras campañas
* Mantén una estructura consistente en todos los flujos
* Documenta el proceso para facilitar el mantenimiento
¡Perfecto! Ahora conoces cómo usar el bloque enlace a conversación para crear sistemas de enrutamiento inteligentes, tanto básicos como avanzados con links de WhatsApp.
## Próximos pasos
Aprende a usar la variable inbound para enrutamiento inteligente.
Aprende a crear y gestionar links de WhatsApp para campañas de marketing.
# Bloques de mensaje - Botones, Lista Interactiva, Simple y con Opciones
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/message-blocks
Los bloques de mensaje son usados como la base fundamental para crear flujos de conversación en Treble.ai. Estos son usados para mostrar información, hacer preguntas, recibir respuestas y más. Aprende a usar los bloques de mensaje para crear flujos de conversación personalizados.
## Introducción
Treble es una herramienta poderosa que te permite diseñar flujos de conversación personalizados para tus clientes. Estos flujos se construyen utilizando bloques de mensaje, que son fundamentales para mostrar información, formular preguntas, recibir respuestas y más. Al diseñar un flujo de conversación, estás programando las interacciones que tu cliente tendrá con tu bot, similar a un árbol de decisión.
Es importante recordar que en Treble existen dos tipos de flujos de conversación:
* **Flujos de conversación inbound**: Son aquellos con los que tus clientes interactúan al enviar un mensaje a tu número de WhatsApp.
* **Flujos de conversación outbound**: Son aquellos que se inician cuando tu empresa contacta a los clientes. Estos flujos siempre deben comenzar con una plantilla de mensaje (HSM) preaprobada por Meta.
Al dominar el uso de los bloques de mensaje, podrás crear flujos de conversación efectivos y personalizados que mejoren la experiencia del cliente y optimicen la comunicación. Para ello, es fundamental entender cómo funcionan los bloques de mensaje y cómo se pueden usar para crear flujos de conversación personalizados.
## ¿Dónde encuentro los bloques de mensaje?
Los bloques de mensaje se encuentran en la sección de **Bloques** del editor de flujos de conversación en Treble. Para acceder a esta vista, siguie los siguientes pasos:
1. Desde la vista principal de **Conversaciones**, has click en el botón **Crear nueva conversación**.
2. Luego, has click en el botón en el panel superior, ubicado a la izquierda, para mostrar el menú de bloques.
3. Selecciona el bloque de mensaje que deseas agregar a tu flujo de conversación y has click en el bloque para agregarlo a tu flujo de conversación.
### Estructura de un bloque de mensaje
Antes de explicar cómo funciona cada bloque de mensaje, y sus diferentes tipos, es importante entender la estructura de un bloque de mensaje.
A continuación, se explica en detalle cada uno de los elementos numerados en la imagen anterior, para que comprendas cómo
configurar y aprovechar al máximo los bloques de mensaje en Treble:
#### Acciones rápidas del bloque
* **Bloque objetivo**: Permite configurar el bloque como un **Bloque objetivo**. Al hacer clic en la estrella, puedes definir metas medibles para tu conversación. Esto es útil para campañas donde necesitas medir conversiones o acciones clave.
Conoce más sobre los bloques objetivos.
* **Cambiar bloque**: Cambia el bloque actual por otro bloque de mensaje. Al hacer clic en el icono, se te mostrará un menú desplegable con los bloques de mensaje disponibles.
* **Eliminar bloque**: Elimina el bloque de mensaje del flujo. Útil para mantener tu flujo limpio y organizado.
#### Cuerpo del mensaje
* Aquí escribes el texto principal que verá el usuario. Puedes personalizar el mensaje usando variables dinámicas, emojis y enlaces. Además, puedes adjuntar archivos multimedia usando el botón (ver punto 3).
#### Adjuntar archivos multimedia
* Permite adjuntar imágenes, documentos, videos o ubicaciones al mensaje. Esto enriquece la experiencia del usuario y es ideal para mostrar productos, enviar manuales o compartir información visual.
Conoce más sobre cómo adjuntar archivos multimedia en tus bloques de mensaje.
#### Opciones de respuesta del bloque
* Puedes agregar botones de respuesta rápida para que el usuario seleccione una opción. Esto facilita la navegación y la toma de decisiones dentro del flujo conversacional. Los botones pueden ser personalizados y se pueden agregar múltiples opciones. Puedes eliminar una de las opciones haciendo click en el botón .
Las opciones en los bloques de mensaje sólo están disponibles en el bloque de mensaje **Botones Interactivos**, **Lista Interactiva** y **Mensaje con Opciones**.
Notarás que cada opción añadida tiene un círculo blanco a la derecha. Este círculo es el que te permite conectar ésta opción con el bloque de mensaje que deseas que se muestre cuando el usuario seleccione esta opción. Para ello, has click en el círculo, mantén presionado y arrastra la flecha hasta el bloque de mensaje que deseas que se muestre cuando el usuario seleccione esta opción.
#### Respuesta no incluida en opciones
* La opción **Respuesta no incluida en opciones** permite definir qué ocurre si el usuario responde con un mensaje que no corresponde a ninguno de los botones disponibles. Puedes configurar redirigir a otro bloque. Es fundamental para manejar respuestas inesperadas y mantener la conversación controlada.
Casos de ejemplo:
* Si el usuario responde con un mensaje que no corresponde a ninguno de los botones disponibles, se redirigirá al bloque de mensaje **Respuesta no incluida en opciones**.
* Si el usuario envía un mensaje vacío o solo con espacios, se puede configurar para que reciba un mensaje de error solicitando una respuesta válida.
* En caso de que el usuario envíe un emoji en lugar de seleccionar una opción, el flujo puede redirigirlo a un bloque que explique cómo interactuar correctamente.
* Si el usuario intenta enviar un archivo adjunto en lugar de seleccionar una opción, se puede redirigir a un bloque que informe que los archivos adjuntos no son aceptados en este contexto.
Para usarlo, has click en el botón **Mensaje no incluido en opciones**, al hacer click, se convertirá en una opción de salida del bloque de mensaje que puedes conectar con otro bloque de mensaje. Para ello, has click en el círculo , mantén presionado y arrastra la flecha hasta el bloque de mensaje que deseas que se muestre cuando el usuario seleccione esta opción.
#### Flujo alterno
* Permite activar el **Flujo alterno**, una funcionalidad avanzada que redirige automáticamente al usuario a otro bloque si no responde después de un tiempo predefinido. Esto es útil para mantener la conversación activa y evitar bloqueos por inactividad. Puedes configurar el tiempo de espera y el destino del flujo alterno.
Conoce más sobre el flujo alterno.
## Configuración avanzada de los bloques de mensaje
Al hacer doble click en cualquier bloque de mensaje, se despliega el panel de **Configuración avanzada** a la izquierda del editor. Aquí puedes personalizar el comportamiento del bloque con las siguientes opciones:
* **Flujo alterno**: Permite activar el **flujo alterno** para redirigir automáticamente al usuario a otro bloque si no responde después de un tiempo predefinido. Es útil para mantener la conversación activa y evitar bloqueos por inactividad.
Aprende a configurar el flujo alterno.
* **Temporizador y límite de mensajes**: **Solo disponible para preguntas abiertas (bloque de mensaje simple)**. Permite que el usuario responda en varios mensajes sin avanzar hasta que se cumpla una condición:
* **Límite de mensajes**: La conversación avanza cuando el usuario envía la cantidad de mensajes configurada.
* **Temporizador**: La conversación avanza cuando transcurre el tiempo configurado desde el primer mensaje del usuario. El temporizador no inicia hasta que el usuario envía su primer mensaje. **El temporizador no puede ser 0.**
* Todos los mensajes enviados por el usuario se concatenan en una sola respuesta, separados por salto de línea. El sistema almacena la cantidad de mensajes en una variable llamada nombre\_variable\_count (por ejemplo, primera\_respuesta\_count).
* Ejemplo: Si el usuario responde en dos mensajes:
Hola
y luego:
Necesito ayuda
El sistema almacenará:
Hola\nNecesito ayuda
y la variable primera\_respuesta\_count tendrá el valor 2.
* **Guardar respuesta**: Permite almacenar la respuesta del usuario en una variable para usarla posteriormente en el flujo. Puedes definir el nombre y tipo de variable (texto, número, email, imagen, etc.).
Aprende a guardar respuestas como variables.
* **Webhooks**: Permite activar un webhook para enviar la respuesta del usuario a un sistema externo en tiempo real, facilitando integraciones avanzadas.
Aprende a usar webhooks en tus bloques de mensaje.
* **Reintento automático**: Si está activado, el sistema intentará reenviar el mensaje automáticamente en caso de que el usuario no responda en un tiempo determinado. Para configurarlo, activa el switch **Reintento automático** después de haber activado la configuración avanzada del bloque de mensaje. Verás las siguientes opciones:
* **Mensaje del reintento automático**: El mensaje que se mostrará al usuario si no responde en el tiempo configurado.
* **Tiempo del reintento automático**: El tiempo en minutos que el sistema esperará a que el usuario responda.
## Bloques de mensaje
A continuación, se explican los diferentes tipos de bloques de mensaje que puedes usar en Treble.
### Botones Interactivos
Los bloques de mensaje **Botones Interactivos** son usados para mostrar un mensaje con botones de respuesta. Estos botones pueden ser personalizados y se pueden agregar hasta 3 opciones. Esta funcionalidad de mostrar mensajes con botones en WhatsApp es exclusiva de WhatsApp Business API. Las opciones de los botones tienen un límite de 20 caracteres.
### Lista Interactiva
Los bloques de mensaje **Lista Interactiva** son usados para mostrar una lista de opciones de respuesta. Estas opciones pueden ser personalizadas y se pueden agregar hasta 10 opciones. Esta funcionalidad de mostrar mensajes con listas en WhatsApp es exclusiva de WhatsApp Business API. Las opciones de la lista tienen un límite de 20 caracteres.
Cuando tu cliente reciba un mensaje con una lista interactiva, verá un botón con el texto de la primera opción de la lista. Al hacer click en el botón, se desplegará una lista de opciones para que el usuario seleccione una.
### Mensaje con Opciones
Los bloques de mensaje **Mensaje con Opciones** son usados para mostrar un mensaje con opciones de respuesta. Estas opciones pueden ser personalizadas y se pueden agregar opciones ilimitadas. Treble muestra éste mensaje como un mensaje con el cuerpo del mensaje que has definido, seguido con una lista enumerada de opciones.
Ejemplo:
Si el cliente envía el siguiente mensaje:
```
Mensaje con opciones numeradas:
1. Opción 1
2. Opción 2
3. Opción 3
4. Opción 4
5. Opción 5
6. Opción 6
```
Treble mostrará el siguiente mensaje:
#### Modo de respuesta
Cuando los clientes reciben éste tipo de mensaje, pueden responder de las siguientes formas:
* **Escribiendo el número de la opción**: El cliente puede escribir el número de la opción que desea, por ejemplo, si el cliente desea seleccionar la opción 1, puede escribir "1".
* **Escribiendo en orden alfabético de la opción**: El cliente puede escribir el texto de la opción que desea, por ejemplo, si el cliente desea seleccionar la opción 1, puede escribir "a".
* **Escribiendo el texto que mas se acerce a alguna de las opciones**: El cliente puede escribir el texto que mas se acerce a alguna de las opciones, por ejemplo, si el cliente desea seleccionar la opción 1, la cual tiene el texto "Ayuda con mi tarjeta", puede escribir "tarjeta".
### Mensaje Simple
Los bloques de mensaje **Mensaje Simple** son usados para mostrar un mensaje sin opciones de respuesta o para capturar una respuesta de texto libre. Esta funcionalidad es particulamente útil para guardar respuestas como variables.
Conoce más sobre cómo guardar respuestas como variables.
¡Éxito! Ahora conoces los bloques de mensaje y cómo usarlos para crear flujos de conversación personalizados.
# 📣 Eventos de Meta — Mide lo que realmente importa
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/meta-events
Esta página explica cómo utilizar el nodo Eventos de Meta dentro del generador de conversaciones de Treble. Este nodo permite a los clientes enviar eventos clave (como compras, creación de pedidos o envíos) a la API de Conversiones de Meta, siempre que la conversación haya iniciado desde un anuncio de Click to WhatsApp. Se detallan los pasos necesarios para configurar el nodo, seleccionar el tipo de evento, definir sus parámetros y ubicarlo correctamente dentro del flujo. También se incluye contexto sobre el propósito del nodo y enlaces a documentación relevante.
**Eventos de Meta** es un nuevo nodo en el generador de conversaciones de Treble que permite registrar y enviar eventos clave de conversión —como compras, acciones en el carrito o intentos de pago— directamente a Meta a través de la **API de conversiones para mensajes comerciales**.
Al integrar esta API, puedes medir el impacto real de tus campañas de Clic a WhatsApp más allá del número de conversaciones iniciadas. Obtendrás visibilidad sobre lo que ocurre *después* de que los usuarios interactúan: ¿compran?, ¿abandonan el carrito?, ¿completan un pago?
**Por qué esto importa**: El Ads Manager de Meta ahora puede atribuir resultados como compras o generación de leads a las conversaciones que tiene tu equipo. Esto ayuda a optimizar el rendimiento de los anuncios, mejorar la segmentación y justificar el gasto en campañas de Clic a WhatsApp.
📚 [Más información sobre la Conversions API de Meta](https://business.whatsapp.com/blog/conversions-api-messaging)
📄 [Lista completa de eventos compatibles con WhatsApp](https://developers.facebook.com/docs/marketing-api/conversions-api/business-messaging/#frequently-asked-questions)
## **🧩 Cómo Funciona**
Usar el nodo **Eventos de Meta** es sencillo y requiere solo unos pocos pasos dentro del generador de conversaciones:
1. **Selecciona el nodo de Eventos de Meta** Desde la lista de nodos disponibles en el generador de flujos, elige **Eventos de Meta**. Verás el ícono de Meta junto a la etiqueta para identificarlo fácilmente.
2. **Elige el tipo de evento** Selecciona uno de los eventos estándar compatibles con Meta, como *Compra*, *Añadir al carrito*, *Iniciar pago*, etc.
3. **Configura los parámetros del evento (solo para eventos de Compra, Pedido creado y Pedido enviado)** Define los valores requeridos como la moneda y el monto para los eventos de compra, creación de pedido y envío de pedido. Puedes usar valores fijos o variables del flujo según tu lógica.
4. **Coloca el nodo en el momento correcto** Añade el nodo después de una interacción o condición que lógicamente dispare el evento que deseas reportar. Por ejemplo, después de que un usuario completa una compra, confirma un pedido o abandona un carrito.
5. **Treble se encarga del resto** Una vez en producción, Treble enviará el evento —incluyendo el ctwa\_clid que lo vincula con el clic original en el anuncio— directamente a la Conversions API de Meta.
\_Nota: Este nodo solo funciona si la conversación fue iniciada a través de un anuncio de Click to WhatsApp y si la cuenta está correctamente configurada con la \_[*Conversions API de Meta.*](https://www.facebook.com/business/help/898185560232180?id=1205376682832142)
*Si no hay un identificador de clic válido (ctwa\_clid), el flujo se ejecutará con normalidad pero no se enviará ningún evento a Meta.*
# Asignación por API
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/transfer-methods/api
Deja que tu propio sistema decida qué agente recibe cada conversación. Treble llama al endpoint que configures con el contexto del chat y asigna la conversación al agente que respondas.
Si tu equipo ya tiene su propia lógica de routing, con el destino **API** no tienes que replicarla en Treble. Treble llama a **tu endpoint** con el contexto del chat y respeta el agente que respondas.
```mermaid theme={null}
sequenceDiagram
participant C as Cliente
participant T as Treble
participant S as Tu servidor
C->>T: La conversación llega al bloque
T->>S: POST con el contexto del chat
S->>S: Decide qué agente debe atender
S->>T: Responde con el agente
T->>C: Asigna la conversación a ese agente
```
## Configuración
En la configuración del bloque, elige **API** y haz clic en **Siguiente**.
Escribe la URL a la que Treble hará la petición `POST` cuando la conversación llegue al bloque.
* **Sin autenticación** — Treble llama tu endpoint sin credenciales.
* **Token / API Key** — ingresa un token que Treble enviará en el header `Authorization` con el formato `Bearer TU_TOKEN`, para que tu endpoint verifique que la llamada viene de Treble.
Selecciona el equipo en **Tags**, agrega **Etiquetas** si las necesitas y haz clic en **Guardar cambios**.
¡Listo! Cuando una conversación llegue al bloque, Treble llamará a tu endpoint para resolver el agente.
## El contrato
Tu endpoint recibe el contexto del contacto y de la conversación, y debe responder con el agente que la atenderá:
```json theme={null}
{
"agent_id": 4567
}
```
También puedes identificar al agente por su email, devolviendo el campo `agent_email` como alternativa.
Tu endpoint debe responder en **menos de 10 segundos**. Si se excede, devuelve un código distinto de `200`, o devuelve un agente que no puede recibir la conversación, Treble aplica el [método de respaldo](/es/docs/build-with-treble/blocks/transfer-methods/overview#prioridad-y-método-de-respaldo) configurado en la plataforma principal.
La referencia completa —el cuerpo exacto que Treble envía, las dos formas de identificar al agente y un ejemplo de implementación— está en la referencia de API.
El cuerpo que Treble envía y la respuesta que debes devolver.
Consulta los agentes de tu cuenta para saber qué id o email devolver.
# Métodos de HubSpot
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/transfer-methods/hubspot
Asigna la conversación al agente propietario del contacto en HubSpot —de inmediato, con un tiempo límite de espera o solo si está conectado— o a un equipo, y sincroniza la asignación con tus workflows de HubSpot.
Con el destino **HubSpot**, la conversación se asigna usando la información de tu CRM. Hay dos métodos disponibles.
## Asignar al agente propietario
Treble asigna el chat al **agente propietario del contacto en HubSpot**. Al seleccionarlo, eliges además *cuándo* se hace esa asignación.
Treble asigna de inmediato el chat al agente propietario en HubSpot, **incluso si no está conectado**. Es la opción más rápida y directa.
Treble verifica si el agente propietario está conectado. Si no lo está, **espera el tiempo indicado** y luego asigna usando el método de respaldo.
El tiempo de espera se define en **minutos** u **horas**.
El chat queda **sin asignar indefinidamente** y solo se asigna cuando el agente propietario se conecte a la plataforma.
Con esta opción la conversación puede quedar sin atender por tiempo indefinido si el propietario nunca se conecta. Úsala solo cuando la atención por parte de esa persona sea más importante que la rapidez de la respuesta.
## Asignar a un equipo
Treble asigna el chat a un **equipo** en lugar de a una persona, sin importar quién sea el propietario del contacto.
Con este método, **Tags** y **Etiquetas** son obligatorios: definen el equipo que recibe la conversación y cómo queda clasificada.
## Esperar antes de asignar chats
Si usas **workflows de HubSpot** para asignar propietarios o etiquetar propiedades, activa esta opción para que Treble espere unos minutos antes de asignar.
Los workflows de HubSpot pueden tardar en procesarse. Sin esa espera, Treble podría asignar la conversación **antes** de que HubSpot haya definido el propietario, y el chat terminaría con el agente equivocado.
```mermaid theme={null}
flowchart LR
A[Contacto] --> B[Workflow de HubSpot]
B --> C[Minutos de espera]
C --> D[Sales.ai asigna el chat]
```
Recomendamos entre **2 y 5 minutos**. Es suficiente para la mayoría de workflows, y puedes ajustarlo según su complejidad.
Esta espera se configura **por bloque**, no globalmente. Así puedes dejar la atención inmediata en los flujos donde no hay workflows involucrados y aplicar la espera solo donde sí la necesitas.
### Casos de uso que habilita
* **Distribución round robin** — usa la función de rotar contactos de los workflows de HubSpot.
* **Asignación basada en propiedades** — asigna según industria, tamaño de empresa o cualquier propiedad personalizada.
La espera no afecta la experiencia del cliente: puede seguir interactuando con el chatbot normalmente mientras Treble espera para hacer la asignación correcta.
## Siguientes pasos
Configura workflows de HubSpot para trabajar con Treble.
Deja que tu propio sistema decida qué agente recibe el chat.
# Métodos de transferencia
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/transfer-methods/overview
Define cómo se asigna cada conversación a un agente desde el propio bloque, y no una sola vez para toda la empresa. Elige entre los métodos de Treble, los de HubSpot o deja que tu propia API decida qué agente recibe el chat.
El bloque de **Métodos de transferencia** te permite decidir **en cada punto de tu flujo** cómo se elige el agente que recibe la conversación.
Antes existía **un solo método de asignación para toda la empresa**: la misma lógica se aplicaba a todas las conversaciones, sin importar por dónde hubiera pasado el cliente. Ahora la configuras **por bloque**, así que un mismo flujo puede enviar a los clientes de ventas a un equipo y a los de soporte a otro, cada uno con su propia lógica.
A esto lo llamamos **multi-método de asignación**: varios métodos conviviendo en un mismo flujo, uno por cada bloque de transferencia que agregues.
## Prioridad y método de respaldo
Esta es la parte más importante de entender: la configuración del **bloque tiene prioridad** sobre la configuración de empresa. La configuración de empresa (en la plataforma principal) pasa a ser el **método de respaldo**.
```mermaid theme={null}
flowchart LR
A[La conversación llega al bloque] --> B{¿El método del bloque logra asignar?}
B -- Sí --> C[Se asigna al agente que resolvió el método]
B -- No --> D[Se aplica el método de respaldo de la empresa]
```
Así, si el método que elegiste no puede asignar la conversación —por ejemplo, el agente específico está desconectado, o tu API no responde— la conversación **no queda en el limbo**: Treble aplica el método de respaldo y alguien la atiende.
El método de respaldo se define una sola vez en **Configuración > Asignación** de la plataforma de agentes.
## Paso a paso
En el editor de conversaciones, haz clic en el botón y busca la sección **Transferencia a humano**. Selecciona **Métodos de transferencia**.
Conecta el bloque al punto de tu flujo donde quieras hacer la transferencia y haz clic en **Configuración**.
Selecciona a dónde quieres enviar la conversación y haz clic en **Siguiente**.
Cada destino tiene sus propios métodos. Configúralo y haz clic en **Guardar cambios**.
¡Listo! Publica la conversación para que la transferencia quede activa.
## Los tres destinos
Asigna a un agente de tu equipo en treble.sales.ai.
Asigna al propietario del contacto o a un equipo de HubSpot.
Tu propio sistema decide qué agente recibe el chat.
### ¿Cuál método elijo?
| Método | Destino | Úsalo cuando… |
| -------------------------- | ------- | --------------------------------------------------------------------------- |
| **Agente con menos chats** | Treble | Quieres balancear la carga entre tus agentes. |
| **Agente aleatorio** | Treble | Quieres repartir parejo sin mirar la carga activa. |
| **Agente específico** | Treble | Ese flujo siempre debe atenderlo la misma persona. |
| **Agente propietario** | HubSpot | Tus agentes responden desde HubSpot y el dueño del contacto debe atenderlo. |
| **Asignar a un equipo** | HubSpot | Quieres que lo atienda un equipo, sin importar quién sea el propietario. |
| **API** | API | Tu operación ya tiene su propia lógica de routing en otro sistema. |
## Campos comunes
Sin importar el destino que elijas, al final de la configuración encontrarás estos campos:
* **Método de respaldo** — se muestra solo para consulta. Es el método configurado en la plataforma principal y se aplica si el método del bloque falla. Usa **Ver configuración** para cambiarlo.
* **Tags (Equipos de sales.treble.ai)** — obligatorio. El equipo al que pertenece la conversación.
* **Etiquetas (Etiquetas de sales.treble.ai)** — opcional. Etiquetas que se aplican a la conversación al transferirla, útiles para filtrar y reportar después.
Cuando no se encuentre ningún agente dentro del equipo seleccionado, el sistema buscará dentro del equipo **Default** de la empresa.
## Preguntas frecuentes
Sí, y es justamente el propósito del bloque. Puedes agregar un bloque por cada camino de tu conversación, cada uno con su propio método.
Siguen funcionando igual. El bloque de [Transferencia a agente](/es/docs/build-with-treble/blocks/agent) y el de [Transferencia a agente en HubSpot](/es/docs/integrations/hubspot/blocks/human-transfer) no cambian, pero te recomendamos usar **Métodos de transferencia** en los flujos nuevos porque reúne todos los métodos en un solo bloque.
En la [plataforma de agentes](/es/docs/agent-platform/welcome). Las conversaciones asignadas con el destino **HubSpot** se responden desde la bandeja de entrada de HubSpot.
Solo para las conversaciones que pasen por ese bloque. La configuración de empresa sigue aplicando como método de respaldo y para las conversaciones que se asignan por fuera del bloque.
# Métodos de Treble
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/transfer-methods/treble
Asigna la conversación a un agente de tu equipo en treble.sales.ai: al que tenga menos chats activos, a uno aleatorio o siempre al mismo agente específico.
Con el destino **Treble**, la conversación se asigna a un agente de tu equipo en treble.sales.ai. Hay tres métodos disponibles.
## Agente con menos chats
Se asigna al agente disponible con **menor carga activa**. Es el método recomendado para balancear el trabajo del equipo: Treble cuenta los chats activos en tiempo real de cada agente del equipo seleccionado y elige al que tenga menos.
## Agente aleatorio
Se selecciona **al azar** entre los agentes disponibles del equipo. Útil cuando quieres repartir parejo a lo largo del tiempo sin mirar la carga de cada momento.
## Agente específico
Treble asignará **siempre al agente que elijas**. Antes, para lograr esto tenías que crear un equipo con un solo integrante; ahora seleccionas al agente directamente de una lista.
Al elegir este método, se abre el selector **Agente a asignar**. Puedes buscar por nombre entre todos los agentes de tu cuenta.
Una vez seleccionado el agente, completa el equipo y las etiquetas y guarda.
Si el agente que elegiste está **inactivo o desconectado**, la conversación no se queda esperándolo: Treble aplica el [método de respaldo](/es/docs/build-with-treble/blocks/transfer-methods/overview#prioridad-y-método-de-respaldo) de tu empresa.
## Campos de configuración
| Campo | Obligatorio | Qué hace |
| -------------------------------------------- | ------------------------------- | ----------------------------------------------------------- |
| **Agente a asignar** | Sí, solo en *Agente específico* | El agente que recibirá siempre la conversación. |
| **Método de respaldo** | — | Solo lectura. Se aplica si el método no logra asignar. |
| **Tags (Equipos de sales.treble.ai)** | Sí | El equipo entre cuyos agentes se aplica el método. |
| **Etiquetas (Etiquetas de sales.treble.ai)** | No | Etiquetas que se aplican a la conversación al transferirla. |
En **Agente con menos chats** y **Agente aleatorio**, el equipo seleccionado en **Tags** define el grupo de agentes candidatos. En **Agente específico** el agente ya está definido, y el equipo se usa para clasificar la conversación.
## Siguientes pasos
Aprende a crear equipos y asignarlos a tus agentes.
Asigna al propietario del contacto o a un equipo de HubSpot.
# WhatsApp Flows
Source: https://help.treble.ai/es/docs/build-with-treble/blocks/whatsapp-flows
Aprende a crear flujos de WhatsApp con Treble. Con esta guía, podrás automatizar tus conversaciones con clientes y mejorar la experiencia de usuario.
En treble.ai, buscamos que las empresas maximicen el uso de WhatsApp como canal clave para conectar con sus clientes de manera efectiva y crecer sus negocios.
Uno de los dolores que hemos identificado en nuestros clientes es la dificultad para recopilar datos de manera eficiente. Sin una herramienta adecuada, las empresas dependen de interacciones con múltiples mensajes que consumen tiempo, resultan en altas tasas de abandono y dificultan la personalización en cada etapa del proceso de ventas.
**WhatsApp Flows** resuelve este problema al ofrecer una solución que permite automatizar flujos de conversación, guiando a los clientes a través de interacciones enriquecidas (tipo formulario) dentro de WhatsApp mejorando tanto la experiencia del usuario como la conversión.
Esta funcionalidad sólo está disponible para WhatsApp en dispositivos móviles y no en WhatsApp Web.
### Esta funcionalidad es clave para:
* **Reducir las tasas de abandono** al recopilar datos en múltiples pasos.
* **Mejorar la calidad y formato de tus datos,** ya que valida que las respuestas correspondan con el tipo de dato solicitado
* **Aumentar las tasas de conversión** en diversas etapas del embudo.
# Crear un WhatsApp Flow en WhatsApp Business Manager
Los WhatsApp Flows son una forma ideal de interactuar con tu audiencia y recopilar información sin salir de WhatsApp. Te permiten automatizar interacciones y simplificar la recopilación de datos, todo desde una única interfaz.
Puedes crear tus Flows directamente desde **WhatsApp Business Manager**, donde Meta ofrece una interfaz fácil de usar, permitiendo que cualquier persona pueda crear un Flow rápidamente, sin importar su experiencia técnica.
Ya sea para recolectar opiniones, realizar encuestas o captar datos de potenciales clientes, WhatsApp Flows es una herramienta muy útil. A continuación, te guiamos paso a paso para crear un Flow usando la interfaz sin código de WhatsApp Business Manager.
## Pasos para crear un WhatsApp Flow
Ingresa a tu cuenta de WhatsApp Business Manager. Este es el lugar donde puedes gestionar todos los aspectos de tu negocio en WhatsApp, incluyendo la creación de Flows para automatizar la interacción con tus clientes.
En el panel principal, dirígete a la sección **Account tools** en el menú lateral y selecciona **Flows**. Aquí podrás ver, editar y crear todos los Flows disponibles para tu cuenta.
Haz clic en el botón **"Crear Flow"** para empezar a construir un nuevo Flow que se adapte a las necesidades de tu negocio.
Pon un nombre a tu Flow para identificarlo fácilmente. Luego, selecciona una categoría según su propósito, como **Registro**, **Atención al cliente**, **Encuesta**, entre otros. Esto ayudará a mantener organizados tus Flows.
Es importante dejar el método sin un endpoint, ya que esta es la opción que soporta Treble actualmente. Esto simplifica el uso del Flow.
Haz clic en **"Crear"** para continuar. Esto abrirá la interfaz donde podrás diseñar el contenido y las interacciones de tu Flow.
En la siguiente pantalla, deberás manipular un archivo JSON para hacer cambios. Puedes seguir nuestra guía: [¿Cómo usar el Playground de Meta para crear tus WhatsApp Flows?](https://www.notion.so/C-mo-usar-el-Playground-de-Meta-para-crear-tus-WhatsApp-Flows-127e42681154808ca333e6f75d29a0b8?pvs=21) para evitar complicaciones con el formato JSON.
Haz clic en "+ Agregar nueva" para crear una pantalla nueva. Dale un título fácil de identificar, como "Calificación de Lead 1 de 2".
En esta pantalla, puedes agregar componentes para interactuar con el usuario.
* **Título** o **Subtítulo**: Proporciona contexto al usuario, como "Queremos saber más sobre tus necesidades".
* **Respuesta de Texto - Respuesta Corta**: Captura datos como nombre y correo electrónico.
* **Elección Única**: Pregunta como "¿Tu empresa tiene más de 50 empleados?" con opciones "Sí" o "No".
* **Grupo de Casillas de Verificación**: Pregunta sobre intereses, como "¿Qué servicios te interesan?".
* **Botón**: Usa un botón etiquetado como "Continuar" para guiar a los usuarios a la siguiente pantalla.
Haz clic en "Copiar JSON del Flow" para guardar la configuración. Luego, usa este archivo JSON en el WhatsApp Business Manager para publicar tu Flow.
```json theme={null}
{"version":"5.0","screens":[{"id":"screen_gkypco","title":"Bienvenido","data":{},"layout":{"type":"SingleColumnLayout","children":[{"type":"Form","name":"flow_path","children":[{"type":"TextHeading","text":"Bienvenido a treble.ai"},{"type":"TextBody","text":"Para brindarte el mejor servicio necesitamos que nos respondas lo siguiente:"},{"type":"TextInput","label":"Nombre","name":"TextInput_8f1836","required":true,"input-type":"text"},{"type":"TextInput","label":"Correo electronico","name":"TextInput_b8cfca","required":true,"input-type":"email","helper-text":""},{"type":"Footer","label":"Continuar","on-click-action":{"name":"navigate","next":{"type":"screen","name":"screen_xqdzlw"},"payload":{"screen_0_TextInput_0":"${form.TextInput_8f1836}","screen_0_TextInput_1":"${form.TextInput_b8cfca}"}}}]}]}},{"id":"screen_xqdzlw","title":"Productos","data":{"screen_0_TextInput_0":{"type":"string","__example__":"Example"},"screen_0_TextInput_1":{"type":"string","__example__":"Example"}},"terminal":true,"layout":{"type":"SingleColumnLayout","children":[{"type":"Form","name":"flow_path","children":[{"type":"TextHeading","text":"¿En qué productos estás interesado?"},{"type":"TextBody","text":"Cuéntanos que productos te interesan para que nuestros agentes te puedan dar información relevante cuánto antes."},{"type":"RadioButtonsGroup","label":"Productos","required":true,"name":"RadioButtonsGroup_f63f8c","data-source":[{"id":"0_Marketing","title":"Marketing"},{"id":"1_Ventas","title":"Ventas"},{"id":"2_Atención_al_cliente","title":"Atención al cliente"}]},{"type":"Footer","label":"Finalizar","on-click-action":{"name":"complete","payload":{"screen_1_RadioButtonsGroup_0":"${form.RadioButtonsGroup_f63f8c}","screen_0_TextInput_0":"${data.screen_0_TextInput_0}","screen_0_TextInput_1":"${data.screen_0_TextInput_1}"}}}]}]}}]}
```
Si te sale un error, revisa que el JSON tenga el formato correcto con este sitio: [https://jsonlint.com/](https://jsonlint.com/)
El Playground asigna valores genéricos que pueden ser difíciles de identificar luego. Recomendamos reemplazar los valores siguiendo nuestra mini guía:
Cuando creas un flow en el **Playground de Meta**, el sistema genera nombres automáticos para los campos (como **TextInput\_8f1836**), lo que puede ser confuso. Sin embargo, **solo necesitas cambiar los nombres en el payload**, y puedes usar los mismos nombres que tienes en los **labels** de los campos, como "Nombre" o "Correo electrónico", para hacer el proceso más fácil.
El **payload** es donde se guardan los datos que los usuarios ingresan en una pantalla para pasarlos a la siguiente. Por ejemplo, cuando un usuario escribe su nombre, ese valor se envía a través del payload para que lo puedas usar en pantallas posteriores.
* **Claridad**: Usar nombres claros y descriptivos te permitirá entender qué información estás capturando.
* **Facilidad de uso**: Si los nombres son fáciles de leer, será más fácil hacer cambios o ajustes en el futuro.
Te ofrecemos dos opciones, en una haces el cambio manual y en la otra sólo tienes que copiar un prompt y tu JSON en ChatGPT y listo.
Por ejemplo, si tienes un campo donde se pide el **Nombre**, debería verse algo así en el JSON:
```json theme={null}
{
"type": "TextInput",
"label": "Nombre",
"name": "TextInput_8f1836",
"required": true
}
```
Para evitar confusión, puedes usar el **label** ("Nombre", en este caso) como el nuevo nombre en el **payload**. De esta manera, no necesitas cambiar los nombres generados automáticamente, solo el payload.
Si el payload original se ve así solo el payload para reflejar los **labels**:
```json theme={null}
"payload": {
"screen_0_TextInput_0": "${form.TextInput_8f1836}",
"screen_0_TextInput_1": "${form.TextInput_b8cfca}"
}
```
```json theme={null}
"payload": {
"Nombre": "${form.TextInput_8f1836}",
"Correo electronico": "${form.TextInput_b8cfca}"
}
```
Si en una pantalla posterior necesitas utilizar el **Nombre** y **Correo electrónico**, usa los nombres de los labels en el payload:
```json theme={null}
"payload": {
"Nombre": "${data.Nombre}",
"Correo electronico": "${data.Correo electronico}",
"Productos": "${form.RadioButtonsGroup_f63f8c}"
}
```
Para ChatGPT sólo debes copiar este prompt y agregar tu JSON para que luego ChatGPT haga los ajustes:
```
Tengo un JSON de WhatsApp Flow y necesito optimizarlo siguiendo las mejores prácticas. Por favor, realiza los siguientes cambios:
Cambia los nombres automáticos generados (como TextInput_8f1836, RadioButtonsGroup_f63f8c) por nombres más descriptivos, basados en los labels de los campos.
Actualiza los payloads de cada pantalla para que también usen estos nombres descriptivos.
Cambia las llaves y variables en el payload para que coincidan con los nombres de los labels.
Asegúrate de que los cambios se apliquen en todos los tipos de componentes: TextInput, RadioButtonsGroup, Footer, y cualquier otro componente presente.
Aquí está mi JSON:
(PEGA AQUÍ TU JSON)
Ejemplos para los cambios:
TextInput: Si el label de un campo es "Nombre", renombra el campo de TextInput_8f1836 a nombre y actualiza el payload de ${form.TextInput_8f1836} a ${form.nombre}.
RadioButtonsGroup: Si el label de un grupo de botones es "Productos", renombra el campo de RadioButtonsGroup_f63f8c a productos_interesados y actualiza el payload de ${form.RadioButtonsGroup_f63f8c} a ${form.productos_interesados}.
Footer: Si tienes un botón de acción como "Continuar" o "Finalizar", asegúrate de que los nombres en el payload reflejen los cambios realizados en los otros campos (por ejemplo, Nombre, Correo electrónico, Productos).
Cambios esperados:
Nombres de los campos reemplazados por los valores de los labels.
Payloads actualizados para que usen los mismos nombres descriptivos.
Llaves y variables en el payload alineadas con los nombres de los labels para asegurar coherencia y facilidad de lectura."
Resultado esperado:
Con este prompt, ChatGPT debería hacer los siguientes cambios:
TextInput:
El nombre generado automáticamente se reemplaza por algo descriptivo (por ejemplo, de TextInput_8f1836 a nombre).
El payload se actualiza: ${form.TextInput_8f1836} se convierte en ${form.nombre}.
RadioButtonsGroup:
El nombre generado se cambia a algo claro y relacionado con el label (por ejemplo, de RadioButtonsGroup_f63f8c a productos_interesados).
El payload se ajusta: ${form.RadioButtonsGroup_f63f8c} se convierte en ${form.productos_interesados}.
Footer:
Asegura que los payloads de los botones de acción utilicen las llaves correctas (por ejemplo, usando ${data.Nombre}, ${data.Correo_electronico} y ${data.Productos} si esos valores se recogen en pantallas previas).
```
Una vez tengas el resultado ya puedes pegarlo en WhatsApp Business Manager.
Pega el JSON creado en el editor y haz clic en **"RUN"** para verificar que el Flow funcione correctamente.
Antes de finalizar, prueba el Flow usando la vista de **preview** para asegurarte de que todo funcione como esperas.
Cuando estés satisfecho con el diseño y funcionamiento del Flow, haz clic en los tres puntos junto al botón de guardar y selecciona **"Publicar"**. Ten en cuenta que no podrás hacer cambios después de publicar.
El primer paso es crear una nueva conversación en Treble, donde agregarás el Flow que creaste previamente. También puedes agregar el Flow a una conversación ya existente o incluso a la conversación inbound que tu empresa tiene configurada.
Para ello, ingresa a Treble, dirígete a la sección de "Conversaciones" y selecciona "Crear una nueva conversación". Esto te permitirá empezar a personalizar el flujo de mensajes de manera específica para tus usuarios.
Una vez que estés en el editor de drag and drop de Treble, podrás usar el bloque especializado para WhatsApp Flows. Este bloque te permitirá agregar tu Flow de manera sencilla y asegurarte de que esté correctamente integrado en el chatbot.
Arrastra y suelta el bloque de WhatsApp Flows en el lugar correspondiente dentro del flujo de la conversación para comenzar con la configuración.
Una vez hayas agregado el bloque de WhatsApp Flows, es momento de configurar el Flow en tres etapas:
En esta primera etapa, selecciona el flujo que deseas implementar. En este paso solo aparecerán los Flows que han sido publicados en WhatsApp Business Manager. Podrás ver un preview para asegurarte de que seleccionaste el Flow correcto.
Esta etapa consiste en crear el mensaje que verán tus usuarios antes de comenzar la interacción con el Flow. Además, debes definir el texto del botón en el que los usuarios harán clic para iniciar el Flow. También puedes elegir si quieres agregar un encabezado y un pie de página (footer) al mensaje.
Finalmente, en la última etapa de configuración, deberás definir los nombres con los que se guardarán las variables. Esto se descompone en los siguientes pasos:
1. **Tomar el valor del payload**: Identifica el valor de la propiedad dentro del payload del Flow.
2. **Definir el nombre y almacenamiento de las variables**: Asigna un nombre que permita guardar este valor dentro de Treble o en el CRM que tengas integrado. Si deseas almacenar las variables en integraciones externas como HubSpot o Google Sheets, usa la siguiente nomenclatura:
* Para HubSpot: "hubspot\_variablename". Por ejemplo, si tienes una variable llamada "name", podrías guardarla como "hubspot\_name".
* Para Google Sheets: "sheets\_variablename". Por ejemplo, si tienes una variable llamada "email", podrías guardarla como "sheets\_email".
Una vez creado el Flow, deberás conectar los nodos dentro del chatbot para definir las acciones que se tomarán según el estado del Flow.
* **Flujo completado**: Puedes configurar una acción para cuando el Flow se complete con éxito, como enviar un mensaje de agradecimiento a los usuarios.
* **Flujo no completado**: También puedes definir qué sucede si el Flow no se completa. En este caso, puedes enviar un mensaje de seguimiento e invitar al usuario a volver a intentar el Flow o proporcionar otra opción.
Finalmente, una vez que hayas terminado de conectar todos los nodos y configurar el Flow, da clic en "Crear" o "Guardar conversación". Tu nuevo Flow estará listo para ser utilizado cuando sea pertinente y proporcionar a tus usuarios una experiencia ágil y automatizada.
¡Y eso es todo! Ahora tienes tu WhatsApp Flow perfectamente integrado en un chatbot de Treble, listo para optimizar tus interacciones con los clientes y brindarles una experiencia personalizada.
Con estos pasos, podrás crear un WhatsApp Flow efectivo para mejorar la comunicación con tus clientes.
# 6 Mejores Prácticas para WhatsApp Flows
WhatsApp Flows es una herramienta poderosa que puede ayudar a tu empresa a optimizar su funnel de conversión a través de WhatsApp. Siguiendo las mejores prácticas, puedes mejorar la experiencia del cliente, reducir el abandono y aumentar la conversión. Esta guía está basada en las mejores prácticas propuestas por Meta y en nuestra experiencia validando la herramienta para optimizar las interacciones con tus clientes.
Los clientes quieren completar tareas rápidamente. Al diseñar un flow, procura que no tome más de cinco minutos completarlo. Si un flow se vuelve demasiado largo, puede generar frustración y los clientes podrían abandonarlo.
### Recomendaciones para Mantener los Flows Concisos:
* **Limita las Tareas por Pantalla**: Incluye solo una tarea por pantalla para evitar abrumar al cliente. Esto hace que la experiencia sea más clara y fácil de seguir.
* **Minimiza los Componentes**: Evita usar demasiados componentes en una sola pantalla, ya que puede saturar la interfaz y ralentizar los tiempos de carga. Si necesitas varios componentes, distribúyelos en varias pantallas.
Los aspectos visuales y de texto de tu flow son cruciales para mantener a los clientes comprometidos e informados.
### Mejores Prácticas de Diseño y Contenido:
* **Llamadas a la Acción (CTAs) Efectivas**: El CTA debe indicar claramente lo que sucederá a continuación. Por ejemplo, usa frases como "Confirmar reserva" para que el cliente sepa exactamente qué acción está realizando.
* **Capitalización y Gramática**: Utiliza mayúsculas al inicio de los títulos y CTAs, mantén una capitalización coherente y siempre revisa el contenido para corregir errores gramaticales y de ortografía. Esto asegura una experiencia profesional y coherente para el cliente.
* **Emojis**: Usa emojis con moderación y considera el contexto. Asegúrate de que se alineen con tu marca y que añadan valor al mensaje en lugar de distraer.
* **Texto de Ayuda**: El texto de ayuda debe proporcionar claridad a los clientes, por ejemplo, el formato correcto para un número de teléfono, la entrada de una fecha o una dirección de correo electrónico.
Para que los formularios sean fáciles de usar y mantener la calidad de los datos de entrada:
### Consejos para Formularios Efectivos:
* **Usa los Componentes Correctos**: Utilizar los componentes correctos hará que tus usuarios tengan una mejor experiencia y el formato de tus datos sea el mejor. Por ejemplo, usa un selector de fechas para fechas de nacimiento o un text input - email para solicitar el correo electrónico de tus clientes.
* **Proporciona Claridad**: Las etiquetas y preguntas deben ser autoexplicativas, y los campos del formulario deben estar ordenados lógicamente (por ejemplo, nombre antes que apellido).
* **Formularios Opcionales**: Si un formulario no es esencial para completar una tarea, hazlo opcional.
Guiar eficazmente a los clientes a través del flow mejora las tasas de finalización.
### Consejos para Navegación Clara y Guiada:
* **Los Clientes Quieren Completar una Tarea**: El CTA debe ir de la mano con el contenido del mensaje. Debe ser breve y concisa, indicando qué tarea puede esperar completar el cliente al abrir el flow.
* **Establece Expectativas**: Informa a los clientes cuánto tiempo tomará completar una tarea, como "Solo debería tomar unos minutos". Utiliza títulos de pantalla concisos y orientados a la acción (por ejemplo, "Confirmar inscripción").
* **Claridad en el Flujo de Iniciación**: Los clientes deciden abrir un flow en función de la claridad de los mensajes de iniciación. La conversación debe sentirse fluida y proporcionar contexto y acciones claras centradas en la tarea.
* **Sin Sorpresas**: La primera pantalla del flow debe reflejar la acción del CTA. Cualquier desviación de la tarea resultará en una mala experiencia para el cliente y podría llevarlo a cerrar el flow.
Asegúrate de estar informando a tus usuarios sobre el uso que harás de sus datos.
### Consideraciones para Opt-in:
* **Claridad del Opt-in**: Es fundamental que el cliente entienda claramente a qué está consintiendo al interactuar con un flow. Proporciona una explicación sencilla y directa del propósito del flow y de cualquier información que se recopilará.
* **Incluir un 'Leer Más'**: Incluye un botón de 'Leer Más' que enlace a la información relevante, como los Términos y Condiciones. Esto aumenta la transparencia y ayuda a construir confianza con los clientes.
Terminar un flow adecuadamente es tan importante como comenzarlo.
# Flujo Alterno
Source: https://help.treble.ai/es/docs/build-with-treble/features/alternate-flow
Aprende a usar el flujo alterno de Treble. Una funcionalidad disponible en cada bloque de mensaje que puede ser activada para que el sistema avance automáticamente hacia la siguiente pregunta o envíe un nuevo mensaje después de un intervalo de tiempo predefinido.
## ¿Qué es el flujo alterno?
En esencia, el flujo alterno es una funcionalidad disponible en cada bloque de mensaje que permite continuar tu flujo de conversación de treble a otro camino si tu cliente no responde al mensaje actual después de un intervalo de tiempo predefinido.
### Ejemplos de casos de usuario
* **Hacer seguimiento automático si el usuario no responde**: Si el usuario no responde a un mensaje actual, el flujo alterno permite enviar un mensaje de seguimiento o una nueva pregunta tras un periodo de inactividad.
* **Avanzar automáticamente a la siguiente pregunta**: Normalmente, Treble espera a que el usuario responda al bloque de mensaje actual antes de avanzar a la siguiente pregunta. Con el flujo alterno, puedes configurar un intervalo de tiempo para que el sistema avance automáticamente a la siguiente pregunta si el usuario no responde.
## ¿Cómo funciona el flujo alterno?
Vamos a configurar un ejemplo de flujo alterno. Para ello, sigue los siguientes pasos:
Ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación". También puedes editar una conversación existente haciendo click en el botón "Editar" de la conversación que deseas editar.
Una vez que hayas ingresado al editor de conversaciones, puedes agregar cualquier bloque de mensajes. También podemos prender el flujo alterno en cualquier bloque de mensaje de una conversación existente. Haz click en el botón y selecciona el tipo de bloque que deseas agregar. En este caso, vamos a agregar un bloque de **Mensaje con opciones** > **Botones interactivos**.
Cuando ya tengas el bloque de mensaje listo al cual quieres activar el flujo alterno, vas a encontrar el switch de **Flujo alterno** en la parte inferior del bloque de mensaje. Haz click en el switch para activarlo.
Al activar el flujo alterno, se te mostrará un campo de texto que de forma predeterminada tiene el valor de **5 minutos**. Este valor indica el tiempo que Treble esperará para enviar el siguiente mensaje si el usuario no responde al mensaje actual. Has click en el campo de texto y cambia el valor al delay que deseas. En este caso, vamos a cambiar el valor a **2 minutos**.
El valor que se puede configurar para el flujo alterno es siempre en minutos.
También puedes configurar el flujo alterno en un bloque de mensaje si haces doble click en el bloque de mensaje y seleccionas la opción **Flujo alterno** en el menú de la izquierda.
Siempre se debe conectar la salida del flujo alterno a otro bloque de mensaje. Si no está conectada a otro bloque de mensaje, treble no te permitirá guardar la conversación.
Como puedes ver, en el ejemplo que estamos configurando, el flujo alterno se activará después de **2 minutos** si el usuario no responde al mensaje actual. Después lo encaminamos a un bloque de mensaje que le pregunta si quiere continuar con el proceso de compra o si tiene alguna duda. Esto puede ser útil para incentivar a que los usuarios continuen con el flujo de tus conversaciones.
En el ejemplo que estamos configurando, le preguntamos al usuario si quiere continuar con el proceso de compra o si tiene alguna duda. Supongamos que el usuario responde a la opción **Sí, continuar**. Esto nos permite que el bloque de mensaje regrese a la pregunta anterior. Esto genera lo que se conoce como un bucle o "loop" en el flujo de conversación.
Si vas a crear un bucle o "loop" en el flujo de conversación, debes asegurarte que tu conversación tenga un inicio y un final sin bucles, de lo contrario, treble no te permitirá guardar la conversación.
Has logrado configurar el flujo alterno para regresar a un bloque de mensaje anterior. Ahora puedes probar la conversación enviando un mensaje a tu número de WhatsApp.
## Uso del flujo alterno para continuar una conversación sin esperar a que el usuario responda
Treble normalmente espera a que el usuario responda al bloque de mensaje actual antes de avanzar a la siguiente pregunta. Sin embargo, puedes configurar el flujo alterno para que el sistema avance automáticamente a la siguiente pregunta si el usuario no responde. Esto permite crear conversaciones mas interactivas y dinámicas dado que puedes enviar múltiples mensajes seguidos sin esperar a que el usuario responda.
### ¿Cómo se hace esto?
El "truco" está en configurar el delay (cantidad de minutos) del flujo alterno en 0. Esto hará que el sistema avance automáticamente a la siguiente pregunta sin esperar a que el usuario responda.
Como puedes ver en la imagen superior, el flujo alterno está configurado en 0 minutos para cada paso. Treble enviará un bloque de mensaje por cada paso de forma casi inmediata. Esto es útil para generar dinamismo en la conversación.
Igualmente, es importante notar que los bloques de mensaje en Treble esperan que la salida de conexión del bloque igualmente esté conectada a otro bloque de mensaje. Si no está conectada a otro bloque de mensaje, treble no te permitirá guardar la conversación. Por lo tanto, **es necesario tanto conectar la salida de conexión del bloque a otro bloque de mensaje como conectar la salida del flujo alterno a otro bloque de mensaje, si éste está activado**.
***
## Preguntas frecuentes
No, dado que para Meta es necesario que tu usario responda a la plantilla de mensaje para dar su consentimiento a continuar con la conversación, no es posible usar el flujo alterno para las plantillas HSM.
# Bloque de Objetivo
Source: https://help.treble.ai/es/docs/build-with-treble/features/goal-block
La funcionalidad de bloque objetivo permite definir metas medibles para tu conversación de WhatsApp
Los bloques de Objetivo en Treble son herramientas fundamentales para estructurar y monitorear la eficacia de los flujos conversacionales automatizados. Estos bloques permiten a los usuarios definir y medir metas específicas en las interacciones con clientes, lo que facilita el seguimiento del progreso dentro de un flujo de conversación. Los objetivos pueden representar distintos hitos importantes, como completar un registro, agendar una cita, descargar un documento, confirmar una compra o cualquier otra acción clave que el usuario debe realizar.
🎈**Definición clara de metas**: Los bloques de objetivo permiten especificar con precisión qué acción o comportamiento del usuario se considera un éxito dentro del flujo. Esto puede ser una respuesta afirmativa, la elección de una opción particular o la finalización de un paso crítico en el proceso conversacional.
💼 **Monitoreo en tiempo real**: Una vez que el flujo está activo, el sistema monitorea cuántos usuarios logran completar los objetivos establecidos. Este monitoreo en tiempo real ofrece una visión clara del rendimiento de la interacción y permite tomar decisiones informadas sobre si el flujo está cumpliendo su propósito.
📒 **Acciones basadas en el cumplimiento de objetivos**: Cuando un usuario cumple un objetivo, el sistema puede desencadenar una serie de acciones automatizadas. Esto puede incluir el final del flujo conversacional, la activación de un nuevo flujo, el envío de una notificación al equipo de ventas o soporte, o incluso la actualización de registros en el CRM. Todo esto asegura que los flujos conversacionales no solo sean interactivos, sino también orientados a resultados.
🐍 **Optimización continua**: Los bloques de objetivo son esenciales para optimizar los flujos conversacionales. Al medir cuántos usuarios alcanzan las metas definidas, los equipos pueden identificar cuellos de botella o puntos de fricción que afecten la conversión. Esto permite realizar ajustes en los mensajes, el tiempo de espera o las opciones presentadas para mejorar el rendimiento general.
👏🏼 **Segmentación y personalización**: Los objetivos pueden ser utilizados para segmentar a los usuarios según su comportamiento. Por ejemplo, aquellos que completan una compra pueden ser dirigidos a flujos específicos de postventa, mientras que los que no lo hacen pueden recibir un flujo de seguimiento o recordatorio. Esto facilita una comunicación más personalizada y relevante para cada usuario.
**Casos de uso comunes**
* **Ventas**: Utilizar un bloque de objetivo para confirmar que un cliente ha realizado una compra o ha mostrado interés en un producto específico.
* **Soporte**: Definir un objetivo cuando un usuario ha resuelto un problema o ha accedido a un recurso de soporte adecuado.
* **Marketing**: Establecer un objetivo cuando un cliente potencial ha completado un formulario o se ha registrado para un evento.
🥁**Video Explicativo**
# Imágenes, documentos y videos en tus bloques de mensaje
Source: https://help.treble.ai/es/docs/build-with-treble/features/media
Aprende a agregar imágenes, documentos y videos a tus bloques de mensaje para que tus clientes puedan ver contenido visual o si quieres enviarles documentos o videos.
## Introducción
Treble te permite agregar imágenes, documentos y videos a tus bloques de mensaje de tus flujos conversacionales para que le lleguen a tus clientes por WhatsApp. Esto permite enriquecer la experiencia del usuario al proporcionar contenido visual atractivo o información adicional en forma de documentos o videos. Al integrar estos elementos multimedia, puedes comunicarte de manera más efectiva y captar mejor la atención de tus clientes, mejorando así la interacción y el compromiso con tu marca.
Algunos ejemplos de uso de imágenes, documentos y videos en tus bloques de mensaje son:
* **Imágenes de productos**: Muestra tus productos con imágenes de alta calidad para que los clientes puedan verlos antes de realizar una compra.
* **Documentos informativos**: Envía documentos como manuales de usuario, guías de instalación o términos y condiciones para proporcionar información detallada.
* **Videos promocionales**: Comparte videos que muestren tus productos en acción o que cuenten la historia de tu marca para atraer a los clientes de manera más dinámica.
Estos elementos no solo mejoran la comunicación, sino que también pueden aumentar la tasa de conversión al proporcionar a los clientes la información que necesitan para tomar decisiones informadas.
## Tipos de archivos soportados
Treble soporta los siguientes tipos de archivos para enviar por medio de bloques de mensaje:
* Imágenes: JPG, PNG, WEBP
* Documentos: PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX
* Videos: MP4, WEBM, OGG
* Ubicación: Envía un cartón nativo de WhatsApp con la ubicación que desees enviar configurada por una dirección.
## Cómo agregar imágenes, documentos y videos a tus bloques de mensaje
Para agregar imágenes, documentos y videos a tus bloques de mensaje, debes seguir los siguientes pasos:
Ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación". También puedes editar una conversación existente haciendo click en el botón "Editar" de la conversación que deseas editar.
Ahora, has click en el botón y selecciona el bloque de mensaje que deseas agregar. Cualquier bloque de mensaje que tengas en tu flujo de conversación puede enviar imágenes, documentos y videos.
Es importante notar que si quieres enviar multimedia dentro de plantillas de mensaje (HSM), debes configurar primero la plantilla de mensaje y agregar el archivo multimedia a la plantilla de mensaje primero. Mas adelante, veremos cómo hacerlo.
En el bloque de mensaje, has click en el botón y selecciona el archivo multimedia que deseas agregar. Verás que al hacer click en el botón, se abrirá un menú con las siguientes opciones:
* **Galería**: Permite adjuntar imágenes o videos de la galería de tu dispositivo.
* **Documentos**: Permite adjuntar documentos o archivos de tu dispositivo.
* **Ubicación**: Permite enviar un cartón nativo de WhatsApp con la ubicación que desees enviar configurada por una dirección.
Si el archivo o documento se ha agregado correctamente, Treble te mostrará el bloque de mensaje con el archivo o documento adjunto.
Puedes ahora agregar los bloques de mensaje que desees para completar el flujo de conversación.
Cuando estés listo para terminar la configuración del flujo de conversación, has click en el botón **Crear conversación** para guardar la configuración del flujo de conversación.
Si deseas cambiar el archivo multimedia que deseas adjuntar en el bloque de mensaje, puedes volver a escoger el archivo multimedia haciendo click en el botón .
¡Éxito! Ya tienes tu flujo de conversación configurado con los bloques de mensaje y los archivos multimedia adjuntos.
## Cómo agregar imágenes, documentos y videos a tus plantillas de mensaje (HSM)
Para agregar imágenes, documentos y videos a tus plantillas de mensaje (HSM), debes seguir los siguientes pasos:
Ve a la sección de plantillas de mensaje al hacer click en el elemento **Plantillas HSM** en el menú de la izquierda. Ahora, has click en el botón ** Nueva Plantilla** para crear una nueva plantilla de mensaje.
Configura la plantilla de mensaje como lo harías normalmente agregando el nombre de la plantilla, su categoría, el idioma y el mensaje. Después, has scroll hacia abajo hasta la sección de **Mensaje**. En la sub-sección de **Encabezado**, verás que hay tres opciones:
* **Ninguno**: La plantilla de mensaje no tendrá encabezado.
* **Texto**: Permite agregar un texto como encabezado a la plantilla de mensaje.
* **Media**: Permite agregar una imagen, video o documento como encabezado a la plantilla de mensaje.
Escoge la opción **Media** y has click en el tipo de archivo que deseas agregar. Luego, has click en el botón **Elegir un archivo** para seleccionar el archivo multimedia que deseas agregar.
Si el archivo o documento se ha agregado correctamente, Treble te mostrará el encabezado de la plantilla de mensaje con el archivo o documento adjunto.
Ahora, has click en el botón **Crear Plantilla** para crear tu plantilla de mensaje.
¡Éxito! Ya tienes tu plantilla de mensaje configurada con el archivo multimedia adjunto. Ahora puedes usar esta plantilla de mensaje en tus flujos de conversación.
# Variables Nativas
Source: https://help.treble.ai/es/docs/build-with-treble/features/native-variables
Las variables nativas son variables que ya vienen preconfiguradas en Treble. Éstas te permiten acceder a información importante en tus flujos de conversación como el código de país del número de teléfono del cliente, el mensaje usado por tu cliente para iniciar un flujo de conversación inbound, o incluso el número de la semana actual. Aprende a usar las variables nativas para crear flujos de conversación personalizados.
## ¿Qué son las variables nativas?
Las **variables nativas** en Treble son variables especiales que el sistema provee automáticamente en cada conversación. No necesitas definirlas ni pedirlas al usuario: siempre están disponibles y puedes usarlas directamente en nodos condicionales o para personalizar mensajes y rutas de tu flujo conversacional.
Estas variables permiten crear flujos inteligentes y personalizados, adaptando la experiencia del usuario según el contexto, la hora, el país, el día de la semana o el mensaje inicial con el que el usuario inicia la conversación.
> **Importante:** Las variables nativas se pueden usar directamente en bloques condicionales, sin necesidad de haberlas capturado previamente en el flujo.
## ¿Por qué son importantes?
* Permiten personalizar la experiencia del usuario de forma automática y dinámica.
* Facilitan la segmentación y el enrutamiento de conversaciones según contexto, horario, país, etc.
* Ayudan a crear flujos más inteligentes y adaptados a las necesidades de cada cliente.
* Reducen la necesidad de pedir información redundante al usuario.
## Variables nativas disponibles
A continuación, te explicamos cada variable nativa, cómo se usa y ejemplos de casos de uso:
### 1. Hora actual (`time`)
Esta variable almacena la **hora actual** (en formato 24 horas, GMT-0) en la que el usuario interactúa con el flujo. Es útil para crear flujos que dependan del horario, como atención fuera de horario laboral, promociones nocturnas, o mensajes personalizados según la hora del día.
```code theme={null}
{{time}}
```
> **Nota:** La hora está en GMT-0. Si tu negocio está en otra zona horaria (por ejemplo, Colombia GMT-5), debes ajustar la condición sumando o restando horas según corresponda. Puedes usar [este conversor de tiempo](https://savvytime.com/converter/utc) para calcular la hora local.
**Ejemplo de uso:**
* Redirigir a un agente solo en horario laboral:
* Si `{{time}}` >= 13:00 y `{{time}}` \< 22:00, mostrar menú de atención.
* Si no, mostrar mensaje de fuera de horario.
### 2. Día de la semana (`weekday`)
Esta variable indica el **día de la semana** en que el usuario interactúa con el flujo. El valor es un número entero donde **1 es lunes** y **7 es domingo**.
```code theme={null}
{{weekday}}
```
Aprende a configurar horarios y tiempo en Treble.
**Ejemplo de uso:**
* Ofrecer promociones solo los fines de semana:
* Si `{{weekday}}` >= 6, mostrar mensaje de promoción especial.
* Cambiar el flujo de soporte según el día:
* Si `{{weekday}}` \<= 5, dirigir a soporte regular.
* Si `{{weekday}}` >= 6, dirigir a soporte de fin de semana.
### 3. Código de país (`country_code`)
Esta variable contiene el **código de país** del número de teléfono del usuario. Es útil para personalizar mensajes, rutas o agentes según el país de origen del cliente. El formato es el siguiente: `+57`, `+55`, etc.
```code theme={null}
{{country_code}}
```
**Ejemplo de uso:**
* Mostrar mensajes en el idioma local según el país:
* Si `{{country_code}}` = +57, mostrar mensajes en español (Colombia).
* Si `{{country_code}}` = +55, mostrar mensajes en portugués (Brasil).
* Asignar agentes especializados por país.
### 4. Business Scope ID (`business_scope_id`)
Esta variable contiene el **Business-Scoped User ID (BSUID)** de WhatsApp que Meta genera automáticamente para la relación de un usuario con tu cuenta de WhatsApp Business específica. Su formato es el **código de país ISO 3166 alpha-2** del usuario, seguido de un punto y un identificador alfanumérico único — por ejemplo `CO.123456789012345` para un usuario en Colombia.
Es especialmente útil cuando un usuario contacta a tu empresa usando un **WhatsApp Business Username** en lugar de compartir su número de teléfono: en ese escenario `{{country_code}}` y `{{cellphone}}` pueden no estar disponibles todavía, pero el BSUID (y su prefijo de país incluido) sí.
```code theme={null}
{{business_scope_id}}
```
**Ejemplo de uso:**
* Detectar el país del usuario cuando `{{country_code}}` todavía no está disponible (por ejemplo, contactos identificados solo por BSUID):
* Si `{{business_scope_id}}` contiene `CO`, tratar al usuario como proveniente de Colombia.
* Si `{{business_scope_id}}` contiene `BR`, tratar al usuario como proveniente de Brasil.
* En cualquier otro caso, mostrar un flujo por defecto.
### 5. Mensaje inicial (`inbound`)
Esta variable almacena el **mensaje con el que el usuario inicia la conversación** (solo para flujos inbound). Permite personalizar la experiencia según la intención o palabra clave con la que el usuario contacta a tu empresa.
```code theme={null}
{{inbound}}
```
**Ejemplo de uso:**
* Si el usuario inicia la conversación con "Soporte", dirigirlo directamente al flujo de soporte.
* Si el usuario escribe "Cotización", mostrar el menú de cotizaciones.
Tip: Puedes usar la variable en bloques condicionales para crear flujos inteligentes según la palabra clave con la que el usuario inicia la conversación.
#### Ejemplo de uso de la variable `inbound` con los Links de WhatsApp
Supongamos que tu empresa tiene varias campañas o canales de adquisición y quieres que, dependiendo del mensaje con el que el usuario inicia la conversación (usando un link de WhatsApp con mensaje predefinido), el usuario sea dirigido automáticamente a un flujo específico. Esto es posible gracias a la variable nativa `inbound`, que captura el mensaje inicial enviado por el usuario.
**Escenario:**
* Tienes tres campañas activas:
1. **Campaña de Soporte**: El link de WhatsApp tiene el mensaje predefinido `Soporte`.
2. **Campaña de Ventas**: El link de WhatsApp tiene el mensaje predefinido `Quiero comprar`.
3. **Campaña de Feedback**: El link de WhatsApp tiene el mensaje predefinido `Dejar feedback`.
Cuando el usuario hace clic en uno de estos links y envía el mensaje, la variable `{{inbound}}` tomará exactamente ese valor. Puedes usar un **bloque condicional** al inicio del flujo para enrutar la conversación según el valor de `inbound`.
**Configuración del bloque condicional:**
* Si `{{inbound}}` es igual a `Soporte` → Redirigir al flujo de soporte.
* Si `{{inbound}}` es igual a `Quiero comprar` → Redirigir al flujo de ventas.
* Si `{{inbound}}` es igual a `Dejar feedback` → Redirigir al flujo de feedback.
* En cualquier otro caso → Mostrar un menú general o mensaje de bienvenida estándar.
```code theme={null}
Condición personalizada:
Variable: inbound
Operador: Igual a
Valor: Soporte → [Flujo de Soporte]
Valor: Quiero comprar → [Flujo de Ventas]
Valor: Dejar feedback → [Flujo de Feedback]
En todos los demás casos → [Menú general]
```
Puedes crear y gestionar los links de WhatsApp desde la sección WhatsApp Links en Treble, definiendo el mensaje predefinido que se usará como valor de inbound.
**Diagrama de flujo simplificado:**
```mermaid theme={null}
graph TD;
A[Usuario hace clic en link de WhatsApp] --> B[Envía mensaje predefinido]
B --> C{Bloque condicional: ¿Cuál es el valor de inbound?}
C -- Soporte --> D[Flujo de Soporte]
C -- Quiero comprar --> E[Flujo de Ventas]
C -- Dejar feedback --> F[Flujo de Feedback]
C -- Otro --> G[Menú general]
```
**Ventajas de este enfoque:**
* Permite medir el rendimiento de cada canal o campaña usando métricas de WhatsApp Links.
* Automatiza la experiencia del usuario, llevándolo directamente al flujo relevante según su intención inicial.
* Facilita la personalización y el análisis de la adquisición de leads por canal.
¡Listo! Así puedes usar la variable inbound junto con los Links de WhatsApp para crear un router inteligente de conversaciones en Treble.
## Casos de uso avanzados
* **Horarios y días combinados:** Puedes combinar `{{time}}` y `{{weekday}}` para crear reglas como "solo mostrar promociones los viernes después de las 6pm".
* **Segmentación internacional:** Usa `{{country_code}}` para adaptar el idioma, moneda o agente según el país del usuario.
* **País de respaldo vía BSUID:** Usa `{{business_scope_id}}` para inferir el país del usuario cuando `{{country_code}}` todavía no está disponible.
* **Automatización inbound:** Usa `{{inbound}}` para enrutar automáticamente a los usuarios según la intención detectada en su primer mensaje.
***
## Próximos pasos
Aprende a crear y usar variables personalizadas y recopiladas por el cliente.
Aprende a usar variables nativas en bloques condicionales.
# Segundo HSM
Source: https://help.treble.ai/es/docs/build-with-treble/features/second-hsm
Aprende a usar el segundo HSM de Treble
En Treble, la funcionalidad Segundo HSM es una herramienta clave para mejorar la interacción con leads y clientes a través de WhatsApp. El uso estratégico del segundo HSM es particularmente efectivo para recuperar leads o clientes que no han respondido a mensajes anteriores, incrementando significativamente la tasa de respuesta general. A continuación, te ofrezco una explicación más detallada sobre cómo funciona esta herramienta y cómo puede ayudarte a maximizar el rendimiento de tus campañas de WhatsApp.
## 🐍 Recuperación de Leads/Clientes Sin Respuesta
El segundo HSM en Treble está diseñado específicamente para volver a captar la atención de leads o clientes que no respondieron al primer contacto. En muchas ocasiones, un lead puede no responder por diversas razones: distracción, falta de tiempo, o simplemente porque el primer mensaje no resonó lo suficiente con sus intereses. El segundo HSM ofrece una oportunidad para reenganchar a estos leads de manera efectiva.
* **Recontacto Estratégico**: Al enviar un segundo HSM, Treble te permite mantener la conversación abierta sin parecer invasivo. Este mensaje puede ser diseñado para abordar directamente posibles preocupaciones, ofrecer más información, o simplemente recordar amablemente al usuario que tiene una conversación pendiente. La idea es proporcionar un valor adicional o un incentivo que motive al lead a responder.
* **Personalización del Mensaje**: El segundo HSM puede ser altamente personalizado en Treble, adaptándose al contexto del lead y al historial de interacciones previas. Esto significa que no se trata solo de un recordatorio genérico, sino de un mensaje que se siente relevante y dirigido específicamente a las necesidades del usuario.
## 🥢 Aumento de la Tasa de Respuesta Total
Una de las ventajas más significativas del uso del segundo HSM es su impacto en la tasa de respuesta general. Según los datos recopilados por Treble, este segundo mensaje puede captar hasta el 40% del total de las respuestas que podrías obtener en una campaña de WhatsApp. Este incremento es crucial, especialmente en campañas donde la tasa de respuesta inicial es baja.
* **Maximización del Alcance**: Al captar respuestas adicionales con el segundo HSM, estás ampliando el alcance efectivo de tu campaña sin necesidad de aumentar la inversión en adquisición de leads. Es decir, estás haciendo más con los recursos que ya tienes, mejorando la eficiencia de tu campaña.
* **Mejora del ROI**: Al incrementar la tasa de respuesta, también estás mejorando el retorno sobre la inversión (ROI) de tu campaña. Cada lead recuperado gracias al segundo HSM es una oportunidad adicional de conversión que de otro modo se habría perdido.
## 👣 Estrategias para un Segundo HSM Eficaz
Para que el segundo HSM sea verdaderamente efectivo en Treble, es importante considerar ciertas estrategias:
* **Timing Adecuado**: El momento en que envías el segundo HSM es crucial. Debe haber suficiente tiempo entre el primer mensaje y el segundo para no parecer insistente, pero no tanto como para que el lead olvide el contexto de la conversación.
* **Llamada a la Acción Clara**: El segundo HSM debe incluir una llamada a la acción clara y convincente. Esto podría ser un recordatorio de una oferta que está por expirar, una invitación a un webinar, o simplemente un enlace para agendar una llamada.
* **Ofrecimiento de Valor Adicional**: A menudo, un lead puede necesitar un pequeño empujón para responder. Considera ofrecer un valor adicional en el segundo HSM, como un descuento exclusivo, una descarga gratuita, o acceso anticipado a un producto o servicio.
El uso del segundo HSM debe ser inteligente y estratégico. Por ejemplo, si un cliente envía su primer mensaje a las 3 de la tarde y decides que el segundo mensaje se envíe 16 horas después, este podría llegar en horas de la mañana, lo cual puede resultar muy invasivo para el cliente. Además, el segundo HSM es más propenso a ser percibido como intrusivo, lo que podría llevar a un bloqueo por parte del cliente. Por lo tanto, es crucial considerar el timing y la percepción del cliente al planificar el envío del segundo HSM.
## 🦑 Integración y Automatización en Treble
Treble permite la automatización del envío del segundo HSM dentro de tus flujos de trabajo de WhatsApp, lo que significa que una vez configurado, no tendrás que preocuparte por seguir manualmente con cada lead. El sistema puede desencadenar automáticamente el envío del segundo mensaje basado en reglas predeterminadas, como la falta de respuesta después de un tiempo específico.
* **Optimización Continua**: Además, Treble ofrece herramientas de análisis que te permiten medir la efectividad del segundo HSM en tiempo real. Esto te da la oportunidad de ajustar el mensaje, la segmentación, o el timing para mejorar continuamente los resultados.
## 🥁 Video Explicativo
# Variables
Source: https://help.treble.ai/es/docs/build-with-treble/features/variables
Las variables son parte crítica de Treble. Éstas te permiten personalizar mensajes y acciones en tus conversaciones. Adicionalmente, te permiten almacenar información en tus sistemas de información o que puedas usar en diferentes partes de un flujo de conversación.
## ¿Qué son las variables?
Las variables en Treble ayudan a almacenar y mostrar información en diferentes partes de un flujo de conversación. Las variables son útiles cuando se desea:
* Mostrar información personalizada en un mensaje. Por ejemplo, puedes mostrar el nombre del cliente en un mensaje.
* Guardar información para usarla en diferentes partes de un flujo de conversación. Por ejemplo, puedes pedir información del cliente como su número de identificación (cédula, NIT, CPF, etc.), su correo electrónico, o su edad.
* Personalizar el comportamiento de un bloque. Por ejemplo, puedes usar una variable para determinar si un cliente debe ser transferido a un agente o no.
* Usar información obtenida en las variables y guardarlas en tu sistema de información. Por ejemplo, puedes guardar el número de teléfono del cliente en tu sistema de información para que puedas usarlo en tu CRM.
Las variables se pueden usar en cualquier tipo de conversación (inbound, outbound) y en cualquier parte de un flujo de conversación, incluyendo en los bloques de texto, listas de opciones, y acciones.
## Tipos de variables
Hay dos tipos de variables en Treble:
* **Variables personalizadas por la compañía**: Son variables en las cuales vas a definir su valor al momento de desplegar tu flujo de conversación. Estas son variables donde tú tienes la información previa a la interacción del cliente. Algunos ejemplos son el nombre de tu cliente, la fecha de su última compra, o el saldo pendiente de la cuenta de un cliente.
* **Variables recopiladas por el cliente**: Son variables que se configuran para almacenar información que el cliente proporciona en tu flujo de conversación. Algunos ejemplos son: pedir la edad del cliente, describir un problema que el cliente tiene, o pedir la dirección de un cliente.
## Definir variables
Toda variable tiene la misma estructura:
* **Nombre**: El nombre de la variable. Recomendamos que uses nombres descriptivos, cortos, en minúsculas, sin espacios, y sin caracteres especiales para que puedas identificar fácilmente el propósito de la variable. Ejemplos: `nombre_cliente`, `edad_cliente`, `direccion_cliente`.
* **Formato**: El formato de la variable. Toda variable en Treble se define usando corchetes: `{{ }}`, por ejemplo: `{{nombre_cliente}}`.
Para definir una variable, solo debes agregarla en el bloque donde quieras usarla. Por ejemplo, si quieres usar la variable `nombre_cliente` en un mensaje, solo debes agregarla en el mensaje.
En este caso, la variable `nombre_cliente` se usará en el mensaje de bienvenida. Sin embargo, puedes usar cuantas variables necesites en un bloque:
En este caso, tenemos las variables `{{correo}}` y `{{fecha_ult_compra}}` en un bloque donde queremos confirmar la información del cliente.
## Ejemplo de creación y despliegue con variables
Supongamos que tenemos el siguiente flujo de conversación donde estamos saludando al cliente por su nombre y luego queremos confirmar que su información en el sistema, tal como su correo electrónico y la fecha de su última compra, es correcta.
Hicimos click en **Crear conversación**, tenemos la conversación creada y ahora queremos desplegarla a 3 clientes haciendo uso de las variables para personalizar los mensajes. ¿Cómo hacemos esto?
Lo primero, es que debemos tener esa información en el sistema. Supongamos que tenemos la siguiente información en nuestro sistema:
| Nombre | Correo | Fecha de última compra |
| ------ | ----------------------------------------- | ---------------------- |
| Juan | [juan@gmail.com](mailto:juan@gmail.com) | 2024-01-01 |
| María | [maria@gmail.com](mailto:maria@gmail.com) | 2024-02-01 |
| Pedro | [pedro@gmail.com](mailto:pedro@gmail.com) | 2024-03-01 |
Tal como vimos en la sección
, tenemos dos opciones para agregar nuestros usuarios:
### Agregar usuarios manualmente
Agregamos la información de los usuarios, uno a uno, en la sección de **Agregar usuarios**. Aqui te van a aparecer los campos de texto para agregar la información de los usuarios uno a uno.
### Agregar usuarios subiendo un archivo CSV
Subimos un archivo CSV con la información de los usuarios. En este caso, el archivo CSV debe tener la siguiente estructura:
| cellphone | country\_code | nombre\_cliente | correo | fecha\_ult\_compra |
| --------- | ------------- | --------------- | ----------------------------------------- | ------------------ |
| 1234567 | 58 | Juan | [juan@gmail.com](mailto:juan@gmail.com) | 2024-01-01 |
| 1234568 | 58 | María | [maria@gmail.com](mailto:maria@gmail.com) | 2024-02-01 |
| 1234569 | 58 | Pedro | [pedro@gmail.com](mailto:pedro@gmail.com) | 2024-03-01 |
Observa que el nombre de las columnas debe corresponder al nombre de las variables que definimos en el flujo de conversación. Nombre del cliente debe corresponder con `nombre_cliente`, Correo debe corresponder con `correo`, y Fecha de última compra debe corresponder con `fecha_ult_compra`. Si no coincide, la conversación no se enviará correctamente.
## Variables en las plantillas (HSMs)
La forma en la cual se definen las variables en las plantillas (HSMs) es identica a la forma en la cual se definen en los bloques. En las plantillas, las variables también se definen usando el formato `{{nombre_variable}}` y se crean las variables como parte del contenido de la plantilla.
Consulta cómo crear variables en plantillas (HSMs).
## Variables para obtener información del cliente
Perfecto, ya sabemos cómo crear variables en Treble y llenarlas con nuestra información. Pero, ¿cómo podemos obtener información del cliente?
Para obtener información del cliente, podemos acceder a la configuración avanzada de los bloques para guardar la respuesta del cliente como variable. Para ello, solo debes hacer doble click en el bloque donde deseas guardar la respuesta del cliente como variable y luego hacer click en el botón **Guardar respuesta como variable**. Aqui te va a aparecer un campo para agregar el nombre de la variable y puedes escoger el tipo de variable que deseas guardar:
* **Texto**: Guarda toda la respuesta del cliente como texto.
* **Número**: Únicamente guarda la parte numérica de la respuesta del cliente. Por ejemplo, si el cliente responde "hola mi número es: 12345", la variable guardará "12345".
* **Imagen**: Si el cliente envía una imagen, la variable guardará la URL de la imagen.
* **Email**: Guarda el correo electrónico del cliente. Si el cliente no proporciona un correo electrónico, la variable guardará un valor vacío/nulo.
* **Video**: Guarda la URL del video del cliente.
* **Ubicación**: Guarda la ubicación del cliente creando dos variables: `latitude` y `longitude`.
* **Código postal**: Guarda el código postal del cliente.
* **Contacto**: Guarda el número de teléfono del cliente.
En este caso, guardamos la respuesta del cliente al bloque de bienvenida como la variable `ayuda_tipo` y especificamos que el tipo de variable es `TEXTO`.
Adicionalmente, también podemos configurar el bloque para que guarde la respuesta del cliente como variable cuando el bloque es una lista de opciones. En este caso, la variable se guardará como el valor de la opción seleccionada por el cliente. Siempre en este caso, el tipo de variable será `TEXTO`.
En este caso, guardamos la respuesta del cliente al bloque de lista de opciones como la variable `resp_cliente`.
## Usar variables obtenidas
Ahora que hemos guardado la respuesta del cliente como variable, ¿cómo podemos usar esa información en nuestro flujo de conversación? Dado que hemos creado las variables `ayuda_tipo` y `resp_cliente`, podemos usar esas variables en cualquier bloque de nuestro flujo de conversación. Solo debemos añadirlas en el bloque donde queremos usar la información con su formato: `{{ayuda_tipo}}` o `{{resp_cliente}}`.
Nota como:
* 🟡 `{{ayuda_tipo}}` se usa en el bloque de bienvenida para mostrar la respuesta del cliente. Representada por la flecha amarilla.
* 🟢 `{{resp_cliente}}` se usa en el bloque de lista de opciones para mostrar la respuesta del cliente. Representada por la flecha verde.
* 🔴 `{{nombre_cliente}}` volvemos a usar esta variable en el bloque siguiente para mostrar el nombre del cliente. Esta variable la vamos a llenar con la información de nuestro sistema de información.
## Próximos pasos
Crea y envía tu primera conversación outbound en Treble.
Crea tu primera plantilla (HSM) en Treble.
# Cómo medir el rendimiento de tus enlaces
Source: https://help.treble.ai/es/docs/build-with-treble/guides/measure-links
Si tienes enlaces (links) en tus mensajes, puedes medir el rendimiento de tus enlaces de manera sencilla. Aprende en esta guía cómo hacerlo.
## Introducción
En Treble, puedes medir el rendimiento de tus enlaces de manera sencilla. Con el sistema de bloque objetivo, puedes entender cuantas veces un usuario ha hecho click en un enlace. Los enlaces los puedes agregar en tus bloques de mensaje de un flujo de conversación. Algunos ejemplos de enlaces son:
* Enlaces a tu sitio web
* Enlaces a tus redes sociales
* Enlaces a tus productos o servicios
* Enlaces a tu blog
* Enlaces a tu newsletter
* Enlaces a tu video
* Enlaces a tu audio
* Enlaces a tu imagen
## Cómo medir el rendimiento de tus enlaces
Es importante entender que hay dos lugares distintos donde puedes agregar enlaces en tus bloques de mensaje:
1. Dentro de cualquier plantilla de mensaje (HSM). (Recordemos que cada flujo de conversación en Treble tiene su propia plantilla de mensaje y debe empezar con ésta).
2. Dentro de un bloque de mensaje después de la plantilla de mensaje.
A continuación, vamos a ver cómo medir el rendimiento de tus enlaces en cada uno de estos lugares.
### Medir el rendimiento de tus enlaces en Plantilla de mensaje (HSM)
En las plantillas de mensaje (HSM), los enlaces se agregan durante la configuración de la plantilla de mensaje. Para ello, debes seguir los siguientes pasos:
Ve a la sección de plantillas de mensaje al hacer click en el elemento **Plantillas HSM** en el menú de la izquierda. Ahora, has click en el botón ** Nueva Plantilla** para crear una nueva plantilla de mensaje.
Configura la plantilla de mensaje como lo harías normalmente agregando el nombre de la plantilla, su categoría, el idioma y el mensaje. Después, has scroll hacia abajo y selecciona activar la opción **Call to action**.
Las plantillas de mensaje (HSM) pueden tener botones de respuesta y a su vez, enlaces. Por lo tanto, no tienes limitación a usar solo enlaces o solo botones de respuesta.
Observerás que aparecen los siguientes campos:
* **Tipo de acción**: Aqui verás por defecto dentro de la opción de **Tipo de acción** que está seleccionada la opción **Número de teléfono**, vamos a cambiarla por **Sitio web**.
* **Texto del botón**: Es el texto que aparecerá en el botón. Lo puedes cambiar a algo como **Visitar mi sitio web** ó **Visitar mi tienda**.
* **Tipo de URL**: Es el tipo de URL que se mostrará en el botón. Lo puedes cambiar a **URL estática** (si quieres que el usuario vaya a una URL que no cambia) o **URL dinámica** (si quieres que el usuario vaya a una URL que tiene elementos dinámicos).
* **Sitio web**: Es el la URL del sitio web o destino a la cual será redirigido el usuario cuando haga click en el botón.
Ahora, has click en el botón **¿Deseas saber cuántos usuarios hicieron clic en el botón?** para activar la medición de enlaces. Una vez hayas hecho click, te saldrá un botón adicional para confirmar la URL de destino. Has click en el botón **Confirmar** para confirmar la URL de destino.
Treble maneja su propio sistema de medición de enlaces, por lo tanto, Treble acorta la URL de destino con un sistema de tracking para poder medir el rendimiento de tus enlaces. Esto es similar a sistemas como (bit.ly) o (tinyurl).
Treble te mostrará un mensaje con el enlace acortado y el mensaje de confirmación. Si deseas no medir el rendimiento de tus enlaces, puedes desactivar la medición de enlaces haciendo click en el botón **Prefiero no saber cuántos usuarios hicieron clic y conservar mi link original**.
Ahora, has click en el botón **Crear Plantilla** para crear tu plantilla de mensaje con el sistema de medición de enlaces activado.
Ahora, vamos a configurar el flujo de conversación con la plantilla de mensaje. Para ello, ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación". También puedes editar una conversación existente haciendo click en el botón "Editar" de la conversación que deseas editar.
Ahora, has click en el botón y selecciona la plantilla de mensaje que deseas agregar. Al momento de agregar la plantilla de mensaje, se activará un modal de configuración de lo que se conoce en Treble como **Bloque objetivo**. Vamos a configurar las siguientes opciones:
* **Selecciona la meta de tu campaña**: Este campo es para definir la meta de tu campaña. Por ejemplo, si quieres medir el rendimiento de tus enlaces, puedes seleccionar la meta **Compartir ofertas/promociones**.
* **Agrega uno o varios objetivos**: Este campo es para definir los objetivos de tu campaña, el cual puede tener uno o varios objetivos. En el dropdown, selecciona la opción **Clic en el botón con link**.
* **Expectativa de conversión**: Verás un slider que te permite definir la expectativa de conversión de tu campaña. El valor por defecto es 80%, pero puedes cambiarlo a un valor que consideres más adecuado.
Una vez hayas configurado los campos, has click en el botón **Crear bloque objetivo** para guardar la configuración.
Si el bloque objetivo se ha configurado correctamente, verás que hay un ícono de una estrella en el bloque de la plantilla de mensaje.
Puedes volver a hacer click en el botón de la estrella para editar la configuración del bloque objetivo.
Puedes ahora agregar los bloques de mensaje que desees para completar el flujo de conversación. Puede que en este caso solo quieras enviar la plantilla de mensaje y que el usuario haga click en el botón de la plantilla de mensaje.
Cuando estés listo para terminar la configuración del flujo de conversación, has click en el botón **Crear conversación** para guardar la configuración del flujo de conversación.
¡Éxito! Ya tienes tu flujo de conversación configurado con la plantilla de mensaje y el sistema de medición de enlaces activado.
### Medir el rendimiento de tus enlaces en bloques de mensaje
En los bloques de mensaje, podemos hacer un proceso similar al que hicimos en la sección anterior. Para ello, debes seguir los siguientes pasos:
Ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación". También puedes editar una conversación existente haciendo click en el botón "Editar" de la conversación que deseas editar.
Ahora, has click en el botón y selecciona el bloque de mensaje que deseas agregar. Cualquier bloque de mensaje que tengas en tu flujo de conversación puede tener enlaces, y para cada uno de ellos, puedes activar la medición de enlaces. Para hacerlo, has click en el botón de la estrella en el bloque de mensaje del cual deseas activar la medición de enlaces.
**Importante**: Diferente a las plantillas de mensaje (HSM), en los bloques de mensaje, no tienes que hacer ninguna configuración especial para adicionar la URL de destino. Simplemente, escribe la URL de destino en el campo de texto.
Una vez hayas hecho click en el botón de la estrella , se activará un modal de configuración de lo que se conoce en Treble como **Bloque objetivo**. Vamos a configurar las siguientes opciones:
* **Selecciona la meta de tu campaña**: Este campo es para definir la meta de tu campaña. Por ejemplo, si quieres medir el rendimiento de tus enlaces, puedes seleccionar la meta **Compartir ofertas/promociones**.
* **Agrega uno o varios objetivos**: Este campo es para definir los objetivos de tu campaña, el cual puede tener uno o varios objetivos. En el dropdown, selecciona la opción **Clic en el botón con link**.
* **Seleccionar link**: Verás un dropdown con los enlaces que tienes en el bloque de mensaje. Puede que tu bloque de mensaje tenga más de un enlace, por lo tanto, puedes seleccionar el enlace que deseas medir.
* **Expectativa de conversión**: Verás un slider que te permite definir la expectativa de conversión de tu campaña. El valor por defecto es 80%, pero puedes cambiarlo a un valor que consideres más adecuado.
Una vez hayas configurado los campos, has click en el botón **Crear bloque objetivo** para guardar la configuración.
Puedes ahora agregar los bloques de mensaje que desees para completar el flujo de conversación.
Cuando estés listo para terminar la configuración del flujo de conversación, has click en el botón **Crear conversación** para guardar la configuración del flujo de conversación.
¡Éxito! Ya tienes tu flujo de conversación configurado con los bloques de mensaje y el sistema de medición de enlaces activado.
## Visualizar el rendimiento de tus enlaces del Bloque Objetivo
Ahora que ya tienes tu flujo de conversación configurado con el sistema de medición de enlaces activado, puedes visualizar el rendimiento de tus enlaces. Para ello, debes seguir los siguientes pasos:
Ve a la sección de "Conversaciones" y haz click en el botón **Métricas** de la conversación que deseas ver las métricas.
Una vez hayas ingresado, has los siguientes pasos:
1. Selecciona la pestaña **Respuestas**
2. En la forma de visualización, selecciona la opción **Tabla General**
3. Vas a ver todas las respuestas generales por cada bloque de mensaje. Has scroll en esta sección hacia la derecha para ver las métricas de los enlaces. Verás los siguientes campos:
| Campo | Descripción |
| ---------------------- | ----------------------------------------------------------------------------- |
| Bloque Objetivo Creado | Sí/No - Indica si el bloque objetivo se ha creado para el enlace. |
| Tipo de Objetivo | El tipo de objetivo que se ha creado para el enlace. |
| Resultados | El número de veces que se ha cumplido con el objetivo de la meta. |
| Resultados % | El porcentaje de veces que se ha cumplido con el objetivo de la meta. |
| Expectativa % | El porcentaje de expectativa de conversión que fijaste en el bloque objetivo. |
Adicionalmente, puedes descargar los datos de las métricas de los enlaces que usaste de los Bloques Objetivos en formato CSV haciendo click en el botón ** Descargar**.
# Configuración de horarios y condiciones de tiempo
Source: https://help.treble.ai/es/docs/build-with-treble/guides/schedules-and-time-configuration
Aprende a configurar horarios de atención, huso horario y manejo de condiciones de tiempo en tus conversaciones de treble.
## Introducción
Es muy común que las empresas necesiten enviar o recibir mensajes de sus clientes en un horario específico. Por ejemplo, si tienes un negocio de comida rápida, puedes enviar mensajes a tus clientes en el horario de apertura de tu negocio, o si tu negocio es una farmacia, puede que solo quieras recibir mensajes de tus clientes en días hábiles.
Treble te permite configurar horarios de atención, huso horario y manejo de condiciones de tiempo en tus conversaciones. Esto te permite enviar y recibir mensajes de tus clientes en un horario específico o incluso en dias específicos de la semana.
### Ejemplos de casos de uso de condiciones de tiempo
* **Horario de atención**: Si tienes un negocio de comida rápida, puedes enviar mensajes a tus clientes en el horario de apertura de tu negocio, o si tu negocio es una farmacia, puede que solo quieras recibir mensajes de tus clientes en días hábiles.
* **Cambio de grupo de agentes según el horario**: Si tu negocio maneja diferentes grupos de agentes según el horario, puedes configurar horarios de atención para cada grupo de agentes.
* **Promociones por temporada**: Si tienes una tienda de ropa, puedes programar el envío de ofertas especiales solo durante los fines de semana o en fechas específicas como Black Friday, enviando mensajes promocionales únicamente en esos períodos.
* **Servicio de delivery con horarios específicos**: Un restaurante puede configurar que solo reciba pedidos por WhatsApp durante su horario de operación (12:00 PM - 10:00 PM) y envíe confirmaciones de pedidos únicamente cuando la cocina esté activa.
* **Soporte técnico por turnos**: Una empresa de tecnología puede configurar diferentes grupos de agentes según el día y hora: agentes de soporte básico durante la semana (9:00 AM - 5:00 PM), agentes especializados los fines de semana, y un sistema de emergencias 24/7 para clientes premium.
### Configuración de condiciones de tiempo - Ejemplo horario de atención
Para configurar condiciones de tiempo, debes seguir los siguientes pasos:
Ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación". También puedes editar una conversación existente haciendo click en el botón "Editar" de la conversación que deseas editar.
Para poder configurar condiciones de tiempo, debes agregar un bloque condicional. Haz click en el botón , has scroll hacia abajo y selecciona el bloque **Condiciones** haciendo click en el bloque.
El bloque condicional es un bloque avanzado que tiene muchas posibilidades. Si quieres saber más sobre el bloque condicional, puedes leer:
Aprende más sobre el bloque condicional.
Una vez que hayas agregado el bloque condicional, vas a hacer doble click en el bloque condicional. Esto desplegará el menú de la izquierda. En el primer campo de **Tipo de pregunta** vas a seleccionar **⏰ Condición horaria**.
Dado que estamos configurando una condición basada en tiempo, debemos también configurar el uso horario. Para ello, en la parte superior vas a hacer click en el botón **Configuración** y vas a seleccionar **Uso horario**. Aqui, escoge el uso horario que deseas. En este caso, vamos a seleccionar **America/New\_York**, pero asegurate de seleccionar el que corresponda a tu país.
Ahora, podemos configurar las condiciones de tiempo. Para ello, vuelve a hacer click en el bloque condicional y vas a encontrar la sección de **Establece condiciones**. Aqui, verás una condición horaria predeterminada que puedes editar. A su vez, puedes agregar más condiciones de tiempo haciendo click en el botón de **Agregar condición**.
Edita los campos del intervalo de tiempo para que se ajusten a tu horario de atención. En este caso, vamos a configurar el horario de atención de 9:00 AM a 5:00 PM. También podemos agregar otra condición de tiempo para que el horario de atención sea de 10:00 AM a 6:00 PM.
Finalmente, verás que el bloque de condiciones ya permite configurar cada camino según la condición horaria. Para ello, puedes agregar los bloques de mensaje que deseas que se envíen en cada condición horaria.
En todos los bloques condicionales en Treble, siempre es necesario conectar la salida del camino **En todos los otros casos** a un bloque de mensaje. Te recomendamos analizar la configuración de tus condiciones de tiempo para asegurarte de que cada camino esté correctamente configurado.
Has logrado configurar el horario de atención para tu conversación. Esto permitirá que tu flujo de conversación se comporte de manera diferente en el horario de atención y en el horario de cierre.
### Ejemplo de cambio de grupo de agentes según el horario
Para configurar un cambio de grupo de agentes según el horario, sigue los pasos de la sección anterior. Cuando ya tengas las condiciones de tiempo configuradas, puedes agregar un bloque de agente para que se cambie el grupo de agentes según la condición horaria.
Aprende a transferir el flujo de conversación a un agente específico.
## Configuración de tiempo - Dias específicos de la semana
En las secciones anteriores, aprendiste a configurar horarios de atención y condiciones de tiempo. Ahora, vamos a aprender a configurar caminos de tu flujo de conversación según dias específicos de la semana. Para ello, vamos a volver a crear o editar una conversación y agregaremos un bloque condicional.
Treble maneja una variable nativa llamada `weekday` que te permite configurar caminos de tu flujo de conversación según el día de la semana. Esta variable es un número entero que va desde 1 hasta 7, donde 1 es lunes y 7 es domingo.
La lista de dias de la semana es la siguiente:
| Número | Día |
| ------ | --------- |
| 1 | Lunes |
| 2 | Martes |
| 3 | Miércoles |
| 4 | Jueves |
| 5 | Viernes |
| 6 | Sábado |
| 7 | Domingo |
Ahora, vamos a configurar un camino de nuestro flujo de conversación según el día de la semana. Para ello:
1. Vamos a agregar un bloque condicional y vamos a configurar el camino según el día de la semana.
2. Has doble click en el bloque condicional y vas a encontrar el menú de la izquierda. Vamos ahora a comparar la variable `weekday` con el número de día de la semana.
3. Escribe en el nombre de la variable la palabra `weekday`, cambia el operador a **Igual a** y escribe el número de día de la semana.
4. ¡Listo! Ahora, puedes agregar los bloques de mensaje que deseas que se envíen en cada condición horaria.
### Ejemplo de cambio de grupo de agentes según dias laborales y fines de semana
En este ejemplo, puedes ver cómo configuramos para los dias Lunes a Viernes (`weekday` entre 1 y 5) un equipo de agentes de soporte básico y para los fines de semana usamos la opción del bloque condicional de **en todos los otros casos** un equipo de agentes especializados.
### Ejemplo mixto de horario de atención y dias específicos de la semana
En este ejemplo, puedes ver cómo configuramos para los dias Lunes a Viernes (`weekday` entre 1 y 5) un equipo de agentes para el horario de atención de la mañana y otro para atención en la tarde. Para los fines de semana (`weekday` entre 6 y 7) un equipo de agentes especializados.
Aqui combinamos el uso de condiciones de tiempo y dias específicos de la semana.
¡Has logrado configurar el horario de atención y dias específicos de la semana para tu conversación! Ahora puedes experimentar con diferentes configuraciones de tiempo para horarios de atención y dias específicos de la semana.
# Objetivo de tu Campaña
Source: https://help.treble.ai/es/docs/build-with-treble/welcome
Aprende a crear tus conversaciones en Treble pensando en el objetivo de tus campañas
## Objetivo de tu Campaña
En la sección de
, aprendiste sobre los conceptos clave de Treble como conversaciones, bloques, plantillas y más. Ahora, vamos a profundizar en cómo puedes crear tus conversaciones en Treble pensando en el objetivo de tus campañas.
WhatsApp es un canal muy poderoso para comunicarse con tus clientes. Sin embargo, no es suficiente con enviar un mensaje y esperar que el cliente te responda. Necesitas tener un objetivo claro para tu campaña y crear una conversación que te permita llegar a ese objetivo.
Empieza por hacerte las siguientes preguntas:
1. ¿Qué tipo de comunicación quieres tener con tus clientes?
2. ¿Qué tipo de conversación inbound o outbound necesitas para llegar a ese objetivo? Deseas que tus clientes inicien una conversación contigo? ¿O deseas que ellos inicien una conversación contigo?
3. ¿Qué tipo de interacción quieres tener con tus clientes? ¿Quieres almancenar información de sus respuestas para usarla en futuras conversaciones? ¿Quieres que tus clientes puedan calificar tu producto o servicio? ¿Quieres que tus clientes puedan calificar tu producto o servicio?
4. ¿Qué tipo de contenido quieres enviar a tus clientes? ¿Quieres enviarles un mensaje promocional? ¿Quieres enviarles un mensaje informativo? ¿Quieres enviarles un mensaje de calidad?
5. ¿Qué tipo de público objetivo tienes? ¿Quieres enviarle un mensaje a todos tus clientes? ¿Quieres enviarle un mensaje a tus clientes que han comprado un producto o servicio?
Hacerte estas preguntas te permitirá crear una conversación que te permita llegar a tu objetivo.
## Recomendaciones en Treble
En Treble, te recomendamos que antes de crear una conversación, tengas los siguientes puntos muy claros:
1. **Objetivo de la conversación**: Define el objetivo de la conversación. Algunos ejemplos son:
* Hacer marketing de tus servicios o productos. Puedes incluso medir la tasa de conversión de tus campañas. Puedes utilizar la funcionalidad de
.
* Recibir información de tus clientes para calificarlos.
* Mandar información de utilidad como recordatorios de citas, recordatorios de pagos, etc.
* Enviar notificaciones sencillas o códigos de verificación.
2. **Tipo de comunicación**: Define si la conversación es inbound o outbound.
* Si esperas que tus clientes inicien una conversación contigo, ¿cómo esperas que inicien la conversación? Puedes tener un código QR, un link en tu sitio web, un número de teléfono, etc.
* Si vas directamente a contactar a tus clientes, ¿dónde tienes su información? ¿En tu CRM? ¿En tu base de datos? ¿En tu sitio web?
3. **Segmentación**: Define a quién le quieres enviar el mensaje. ¿A todos tus clientes? ¿A tus clientes que han comprado un producto o servicio? ¿A tus clientes que han comprado un producto o servicio?
* Te recomendamos que segmentes a tus clientes por grupos. Por ejemplo, puedes tener un grupo de clientes que han comprado un producto o servicio y otro grupo de clientes que no han comprado un producto o servicio.
* Hacer comunicación por WhatsApp es un arte. No es suficiente con enviar un mensaje y esperar que el cliente te responda. Necesitas experimentar y probar diferentes mensajes para ver cuál es el que mejor funciona. Recomendamos que si esperas enviar una campaña a un grupo muy númeroso de clientes, primero la pruebes en un grupo más pequeño para ver si funciona. Ejemplo: Si esperas enviar una campaña a 1000 clientes, primero la pruebes en 100 clientes para ver si funciona. Puedes incluso utilizar la funcionalidad de
para medir la tasa de conversión de tus campañas.
4. **Contenido**: Define el contenido que quieres enviar a tus clientes.
* WhatsApp es un canal de comunicación muy rico. Puedes enviar imágenes, videos, audios, documentos, etc. Experimenta añadiendo emojis a tus mensajes para que sean más atractivos.
* Adicionalmente, WhatsApp tiene funcionalidades como botones interactivos, listas de mensajes, etc. Puedes utilizar estas funcionalidades para crear una conversación más interactiva y personalizada.
## Próximos pasos
Crea y envía tu primera conversación outbound en Treble.
Crea tu primera plantilla (HSM) en Treble.
# Bloque Condicional
Source: https://help.treble.ai/es/docs/integrations/hubspot/blocks/conditional
El bloque condicional te permite tomar decisiones en función de las respuestas del usuario para dirigir el flujo de una conversación de Treble. Esta guía te muestra cómo utilizar este bloque en función de la integración con HubSpot.
# Bloque Condicional
El bloque condicional es un bloque extremadamente útil para dirigir el flujo de una conversación de Treble en función de las respuestas del usuario. Este bloque te permite evaluar una expresión y tomar decisiones en función de si la expresión es verdadera o falsa o si cumple con ciertas condiciones.
## Antes de empezar
Los bloques condicionales utilizan *variables* de Treble para evaluar las condiciones. Antes de empezar, asegúrate de que tienes claro cómo funcionan las variables de Treble. Si no lo tienes claro, puedes leer nuestra guía sobre variables de Treble aquí:
Adicionalmente, en el contexto de la integración con HubSpot, los bloques condicionales utilizan las propiedades de los contactos de HubSpot para evaluar las condiciones. Si no tienes claro cómo funcionan las propiedades de los contactos de HubSpot, puedes leer nuestra guía sobre variables relacionadas a los contactos de HubSpot aquí:
2. Dirígete a **Crear Conversación**
3. Has click en el botón de para desplegar el menú de bloques
4. Has scroll hasta encontrar el bloque de **Condiciones**
5. Has click en el bloque de **Condiciones** para agregarlo a tu conversación
6. Mueve el bloque de **Condiciones** a la posición que desees en tu flujo
7. Conecta el bloque de **Condiciones** con el bloque de **Pregunta**
8. Una vez hayas agregado el bloque de **Condiciones**, has doble click en el bloque para desplegar el menú de configuración
## Configuración del bloque condicional
Al hacer doble click en el bloque de **Condiciones**, se desplegará el menú de configuración. En este menú, podrás configurar las condiciones que deseas evaluar.
1. El primer campo que vas a encontrar es el de **Condición personalizada**. Este campo te permite evaluar una expresión donde vamos a utilizar una variable de Treble y evaluarla con una condición. Por ejemplo, si queremos evaluar si el usuario es mayor de edad y tenemos una variable de Treble llamada `edad` que contiene la edad del usuario, podemos evaluar la condición `edad > 18`.
En esta guía solo vamos a utilizar la condición personalizada, pero en el menú de configuración también puedes encontrar la **Condición horaria**.
2. Después encontrarás la sección de **Establece condiciones**. Hay 3 elementos sobre una condición:
* **Variable**: La variable de Treble que vamos a evaluar.
* **Operador**: El operador que vamos a utilizar para evaluar la condición.
* **Valor**: El valor que vamos a utilizar para evaluar la condición. Aqui podemos usar un valor fijo o una variable de Treble.
### Operadores Disponibles
Existen 8 operadores disponibles:
* **Igual a**: Compara si el valor de la variable es igual al valor establecido. Por ejemplo, si la variable es igual a `18`, y el valor es `18`, la condición será verdadera.
* **Mayor a**: Compara si el valor de la variable es mayor al valor establecido. Por ejemplo, si la variable es igual a `18`, y el valor es `17`, la condición será falsa.
* **Contiene**: Compara si el valor de la variable contiene el valor establecido. Por ejemplo, si la variable es igual a `peras, manzanas, cerezas`, y el valor es `manzanas`, la condición será verdadera.
* **Menor a**: Compara si el valor de la variable es menor al valor establecido. Por ejemplo, si la variable es igual a `18`, y el valor es `17`, la condición será verdadera.
* **Menor o igual a**: Compara si el valor de la variable es menor o igual al valor establecido. Por ejemplo, si la variable es igual a `18`, y el valor es `18`, la condición será verdadera.
* **Mayor o igual a**: Compara si el valor de la variable es mayor o igual al valor establecido. Por ejemplo, si la variable es igual a `18`, y el valor es `19`, la condición será verdadera.
* **Diferente a**: Compara si el valor de la variable es diferente al valor establecido. Por ejemplo, si la variable es igual a `18`, y el valor es `19`, la condición será verdadera.
* **No contiene**: Compara si el valor de la variable no contiene el valor establecido. Por ejemplo, si la variable es igual a `peras, manzanas, cerezas`, y el valor es `manzanas`, la condición será falsa.
Estos operadores en conjunto con poder utilizar variables de HubSpot dentro de Treble y poder capturar las respuestas de los usuarios en variables de Treble, nos permite crear flujos muy complejos y personalizados.
## Casos de uso
**¿En qué momento usarlas?** Las condiciones son muy útiles cuando quieres crear dos caminos diferentes en tu conversación según una variable específica.
**Ejemplo:** Si operamos en varios países, podemos usar condiciones para dirigir automáticamente al cliente con el agente que atiende su país de residencia.
Nota como en el ejemplo, estamos revisando si el pais del usuario es igual a `Colombia` y si es así, se dirige al agente de Colombia. Para esto estamos usando directamente la variable de HubSpot `hubspot_country` y el operador `Igual a`. Dado que la variable `hubspot_country` contiene el país del usuario, la condición será verdadera si el país del usuario es Colombia y falsa en caso contrario.
## Casos Avanzados
En el ejemplo anterior, estuvimos utlizando una variable de HubSpot para evaluar la condición con respecto al pais del usuario y solo teniamos dos caminos posibles. Sin embargo, en muchas ocasiones queremos evaluar múltiples condiciones y tener múltiples caminos posibles. Para esto, podemos utilizar múltiples condiciones. Al hacer click en el bloque de **Condiciones**, puedes ver que hay un botón de **Agregar condición** que te permite agregar múltiples condiciones.
# Bloque de Acción en CRM
Source: https://help.treble.ai/es/docs/integrations/hubspot/blocks/crm-action
Actualiza y crea contactos, negocios, empresas y tickets de HubSpot desde una conversación de Treble.
# Acción en CRM
El bloque **Acción en CRM** escribe información en HubSpot mientras la conversación ocurre. Cuando el contacto responde algo en tu flujo, este bloque guarda esa información en HubSpot sin que nadie tenga que hacerlo a mano después.
Desde septiembre de 2026 el bloque ya no se limita a los contactos. Ahora puedes escribir también en **negocios, empresas y tickets**.
Este bloque solo **escribe** en HubSpot. Si lo que necesitas es **leer** un dato de HubSpot y usarlo dentro de la conversación, usa el bloque
* Treble necesita saber quién es el contacto. Eso ocurre automáticamente cuando la conversación empieza.
## Agrega el bloque a tu conversación
1. Inicia sesión en
2. Dirígete a **Crear Conversación**
3. Haz clic en el botón para desplegar el menú de bloques
4. Busca el bloque **Acción en CRM** y haz clic en él para agregarlo
5. Muévelo a la posición que quieras y conéctalo con el bloque anterior
6. Haz doble clic sobre el bloque para abrir su configuración
## Paso 1: elige el objeto
Lo primero que configuras es **en qué objeto de HubSpot quieres escribir**.
| Objeto | Cuándo usarlo |
| ------------ | -------------------------------------------------------------------------- |
| **Contacto** | Guardar datos de la persona: nombre, correo, ciudad, estado del lead |
| **Negocio** | Actualizar la etapa, el monto o cualquier dato de una oportunidad de venta |
| **Empresa** | Guardar información de la compañía a la que pertenece el contacto |
| **Ticket** | Actualizar el estado o la prioridad de un caso de soporte |
### La diferencia importante entre contacto y los demás objetos
El **contacto** es la persona con la que estás hablando. Treble ya sabe quién es, así que puede escribir en él directamente.
Los **negocios, empresas y tickets** no son la persona. Son registros que están **asociados** a esa persona en HubSpot. Por eso Treble primero tiene que encontrar cuál de ellos usar, y para eso existe la jerarquía.
Treble solo puede escribir en negocios, empresas y tickets que ya estén **asociados al contacto** en HubSpot. Si el negocio existe en tu cuenta pero no está asociado a ese contacto, Treble no lo va a encontrar.
## Paso 2: la jerarquía
Esta es la parte que más dudas genera, así que vale la pena entenderla bien.
Un contacto puede tener **varios** negocios asociados. Imagina un cliente que te compró en enero, en marzo y en agosto: en HubSpot eso son tres negocios colgando del mismo contacto. Cuando tu conversación dice "actualiza el negocio", Treble necesita saber **cuál de los tres**.
La **jerarquía** es la regla que responde esa pregunta.
| Opción | Qué hace |
| ------------------ | -------------------------------------------------------------------------------- |
| **Primero creado** | Toma el negocio más antiguo de los asociados al contacto |
| **Último creado** | Toma el negocio más reciente de los asociados al contacto |
| **Personalizado** | Toma los negocios cuya propiedad sea **exactamente igual** al valor que indiques |
### Cómo funciona "Personalizado"
Eliges una propiedad y un valor. Treble se queda solo con los objetos donde esa propiedad es **idéntica** al valor.
Por ejemplo, propiedad `Etapa del negocio` igual a `Presentación programada`: Treble actualizará el negocio del contacto que esté en esa etapa.
"Personalizado" filtra por igualdad exacta, no ordena. Si el contacto tiene **dos o más** objetos que cumplen la condición, Treble toma el primero que HubSpot le devuelve, y ese orden no lo controlas tú. Usa un valor que identifique un solo registro.
En el valor de "Personalizado" también puedes usar una variable de Treble, por ejemplo `{{numero_de_pedido}}`. Así puedes encontrar el negocio exacto del que te está hablando el cliente.
Cuando el objeto es **contacto**, no verás jerarquía. No hace falta: solo hay un contacto.
## Paso 3: elige la propiedad y el valor
Después seleccionas **qué propiedad** del objeto quieres escribir y **qué valor** le quieres poner. La forma de escribir el valor depende del tipo de propiedad en HubSpot:
| Tipo de propiedad en HubSpot | Qué verás en Treble |
| --------------------------------- | ---------------------------------------------------------------------- |
| Texto, número | Un campo libre donde escribes el valor |
| Desplegable, casilla de selección | La lista de opciones que ya existen en HubSpot |
| Selección múltiple | Las opciones, más la posibilidad de **agregar, eliminar o reemplazar** |
### Usar respuestas del cliente como valor
En las propiedades de **texto y número** puedes escribir una variable de Treble en lugar de un valor fijo. Así guardas en HubSpot lo que el cliente acaba de responder.
El flujo típico son dos bloques:
1. Una **pregunta abierta**: "¿Cuál es el nombre de tu empresa?", guardando la respuesta en una variable llamada `empresa`.
2. Un bloque de **Acción en CRM** donde, en el valor, escribes `{{empresa}}`.
**Escribe la variable sola, sin texto alrededor.**
✅ `{{empresa}}`
❌ `Negocio de {{empresa}}`
Treble reemplaza **todo el campo** por el valor de la variable, no solo la parte entre llaves. Si escribes `Negocio de {{empresa}}`, en HubSpot no quedará "Negocio de Acme": quedará solo "Acme".
Por la misma razón, solo se tiene en cuenta **la primera** variable del campo. `{{nombre}} {{apellido}}` guardará únicamente el nombre.
Si la variable está vacía porque el cliente no llegó a responder esa pregunta, el bloque **no escribe nada** y la conversación continúa. No verás un error.
## Crear un nuevo objeto con esta configuración
Al final de la configuración hay un interruptor llamado **Crear un nuevo objeto con esta configuración**. Este interruptor cambia por completo lo que hace el bloque.
* **Apagado (por defecto):** Treble **busca** un objeto asociado al contacto y lo actualiza. No crea nada.
* **Encendido:** Treble **crea siempre** un objeto nuevo, le pone el valor que configuraste y lo asocia al contacto. No revisa si ya existe uno.
Son dos caminos separados, no uno solo. Treble **no** busca primero y crea si no encuentra.
* Si el interruptor está **apagado** y el contacto no tiene ningún negocio asociado, el bloque no hace nada y la conversación sigue de largo.
* Si el interruptor está **encendido**, se crea un negocio nuevo cada vez que un cliente pasa por ese bloque, aunque ya tuviera uno.
Cuando el interruptor está encendido, la jerarquía deja de aplicar. Treble no está buscando nada, así que no hay entre qué elegir.
### Todo el comportamiento en un diagrama
```mermaid theme={null}
flowchart TD
A[El cliente llega al bloque de Acción en CRM] --> B{¿Qué objeto elegiste?}
B -->|Contacto| C[Actualiza el contacto. Sin jerarquía]
B -->|Negocio, empresa o ticket| D{¿Crear un nuevo objeto?}
D -->|Encendido| E[Crea uno nuevo y lo asocia al contacto]
D -->|Apagado| F{¿El contacto tiene objetos asociados?}
F -->|No| G[No hace nada y la conversación continúa]
F -->|Sí| H[Aplica la jerarquía]
H --> I[Actualiza el objeto elegido]
```
## Configuración avanzada
Dentro de **Configuración avanzada** hay una sola opción: **Actualización de propiedades en tiempo real**.
Normalmente Treble agrupa las escrituras hacia HubSpot y las envía en bloque. Esto es más lento en aparecer dentro de HubSpot, pero es mucho más seguro: HubSpot limita cuántas peticiones puede recibir una cuenta por minuto.
Al encender esta opción, cada escritura se envía a HubSpot de inmediato.
Te recomendamos mantener esta opción **apagada**. Si la enciendes, corres el riesgo de que existan fallas en tus conversaciones por superar el límite de peticiones (Rate Limit) de HubSpot.
Enciéndela solo si el dato tiene que estar en HubSpot en ese mismo segundo, por ejemplo porque un workflow de HubSpot se dispara con esa propiedad.
Cuando la opción está encendida, el bloque muestra una advertencia roja en el lienzo de la conversación para que no se te olvide:
## Casos de uso
### Marcar la etapa del negocio según lo que responde el cliente
Preguntas al cliente si quiere agendar una demostración. Si responde que sí, un bloque de Acción en CRM sobre el objeto **negocio**, con jerarquía **Último creado**, cambia la etapa a "Demostración agendada". El equipo comercial ve el cambio en su pipeline sin tocar nada.
### Registrar el interés del cliente en el contacto
Una pregunta cerrada con las opciones de tu catálogo, y un bloque de Acción en CRM sobre el objeto **contacto** que guarda la opción elegida en una propiedad de contacto. Con eso puedes segmentar campañas después.
### Crear un negocio nuevo por cada solicitud
Un cliente que pide una cotización nueva cada mes. Enciendes **Crear un nuevo objeto con esta configuración** sobre el objeto **negocio** y usas `{{producto_de_interes}}` como nombre del negocio. Cada solicitud queda como una oportunidad separada, asociada al mismo contacto.
### Actualizar el ticket de soporte que el cliente está consultando
El cliente escribe su número de caso, lo guardas en una variable, y usas jerarquía **Personalizado** con la propiedad del número de ticket igual a `{{numero_de_caso}}`. Treble actualiza exactamente ese ticket y no otro.
## Si algo no funciona
### No encuentro la propiedad que quiero usar
Treble guarda una copia de las propiedades de tu cuenta de HubSpot en vez de pedirlas cada vez. Si creaste la propiedad hace poco, todavía no está en esa copia.
La solución es actualizar las propiedades con el botón de sincronizar. Revisa
### El bloque no escribió nada en HubSpot
Revisa en este orden:
1. **¿El contacto tiene el objeto asociado?** Si elegiste negocio, empresa o ticket y el interruptor de crear está apagado, el contacto tiene que tener uno asociado en HubSpot. Ábrelo en HubSpot y confírmalo.
2. **¿La jerarquía dejó algún objeto fuera?** Con "Personalizado", si ningún objeto cumple la condición exacta, no hay nada que actualizar.
3. **¿La variable tenía valor?** Si usaste `{{una_variable}}` y el cliente nunca respondió esa pregunta, el bloque no escribe.
4. **¿Escribiste texto junto a la variable?** Revisa que el campo contenga solo `{{variable}}`.
### Se están creando negocios duplicados
Es el interruptor **Crear un nuevo objeto con esta configuración**. Con esa opción encendida se crea uno nuevo cada vez que alguien pasa por el bloque. Si lo que querías era actualizar el que ya existe, apágalo y usa la jerarquía.
### El dato tarda en aparecer en HubSpot
Es el comportamiento normal: las escrituras se agrupan y se envían juntas. Si necesitas que sea inmediato, revisa la sección de configuración avanzada de esta misma página.
# Bloque Objeto CRM
Source: https://help.treble.ai/es/docs/integrations/hubspot/blocks/crm-variable-assignment
Lee una propiedad de un contacto, negocio, empresa o ticket de HubSpot y guárdala en una variable para usarla dentro de la conversación.
# Objeto CRM
El bloque **Objeto CRM** hace lo contrario del bloque de Acción en CRM: en vez de escribir en HubSpot, **lee** un dato de HubSpot y lo guarda en una variable de Treble. A partir de ahí puedes usarlo en cualquier parte de la conversación.
Con esto puedes, por ejemplo, saludar al cliente mencionando el monto de su última cotización, o mandarlo por un camino distinto según la etapa en la que esté su negocio.
En el menú de bloques este bloque aparece como **Asignar variables**, con la descripción "Asocia objetos a partir de contactos". Una vez que lo agregas a la conversación, el bloque se llama **Objeto CRM**. Son el mismo bloque.
Las propiedades del **contacto** ya están disponibles automáticamente como variables `hubspot_...` en toda la conversación. Este bloque es sobre todo útil para leer propiedades de **negocios, empresas y tickets**, que no se cargan solas. Revisa
2. Dirígete a **Crear Conversación**
3. Haz clic en el botón para desplegar el menú de bloques
4. Busca el bloque **Asignar variables** y haz clic en él para agregarlo
5. Conéctalo en el punto del flujo donde necesites el dato, **antes** del bloque que lo va a usar
6. Haz doble clic sobre el bloque para abrir su configuración
El bloque tiene que ir **antes** del bloque donde uses la variable. Si lo pones después, la variable estará vacía cuando el mensaje se envíe.
## Configura el bloque
### 1. Selecciona un objeto y su jerarquía
Igual que en el bloque de Acción en CRM, eliges de qué objeto quieres leer: **contacto, negocio, empresa o ticket**.
Si eliges algo distinto al contacto, tienes que decirle a Treble **cuál** de los objetos asociados usar, con la jerarquía:
| Opción | Qué hace |
| ------------------ | ---------------------------------------------------------------- |
| **Primero creado** | El más antiguo de los asociados al contacto |
| **Último creado** | El más reciente de los asociados al contacto |
| **Personalizado** | Aquel cuya propiedad sea exactamente igual al valor que indiques |
La jerarquía funciona exactamente igual que en el bloque de Acción en CRM, incluido el diagrama de comportamiento. Si tienes dudas sobre cuál elegir, revisa
### 2. Define la propiedad que se va a colocar en la conversación
Selecciona la propiedad del objeto cuyo valor quieres traer a la conversación. Por ejemplo, `Amount` para el monto de un negocio, `Etapa del negocio`, o la prioridad de un ticket.
### 3. Ponle nombre a la variable
En **Nombre de variable** escribes cómo se va a llamar el dato dentro de Treble. Ese es el nombre que vas a usar entre llaves más adelante.
Por ejemplo, si le pones `cantidad`, en los siguientes bloques podrás escribir `{{cantidad}}`.
Usa nombres en minúscula y sin espacios ni tildes, como `monto_cotizacion` o `prioridad_ticket`. Así son más fáciles de recordar y de escribir.
## Cómo se ve el bloque en tu conversación
Una vez configurado, el bloque muestra un resumen de lo que hace directamente en el lienzo: el objeto, la jerarquía, la propiedad que lee y la variable donde la guarda.
La variable aparece ya escrita entre llaves, lista para usar. Haz clic en el ícono de copiar que está a su derecha y pégala en el bloque donde la necesites. Así evitas errores de escritura.
## Qué puedes hacer con la variable
Una vez guardada, la variable se comporta como cualquier otra variable de Treble:
* **Mostrarla en un mensaje:** "Tu cotización por `{{cantidad}}` sigue vigente."
* **Evaluarla en un bloque condicional:** mandar al cliente por un camino u otro según la etapa de su negocio. Revisa
* **Reutilizarla en un bloque de Acción en CRM:** leer un dato de un objeto y escribirlo en otro.
* **Pasársela a un agente de IA** como contexto de la conversación.
## Casos de uso
### Retomar una cotización sin preguntar por ella
Lees el monto y la etapa del **último negocio creado** del contacto, y abres la conversación con esos datos. El cliente siente que le estás hablando de su caso, no de una plantilla.
### Enrutar el soporte según la prioridad del ticket
Lees la prioridad del ticket asociado al contacto y, con un bloque condicional, mandas los casos de prioridad alta directo a un agente humano y los demás al agente de IA.
### Personalizar la oferta según la empresa
Lees el tamaño o el sector de la **empresa** asociada al contacto y usas esa información para decidir qué plan mostrarle.
## Si algo no funciona
### La variable llega vacía
1. **¿El contacto tiene ese objeto asociado?** Si el contacto no tiene ningún negocio asociado en HubSpot, no hay nada que leer.
2. **¿La jerarquía dejó todo fuera?** Con "Personalizado", si ningún objeto cumple la condición exacta, la variable queda vacía.
3. **¿El bloque está antes del que usa la variable?** Es la causa más común.
4. **¿La propiedad tiene valor en HubSpot?** Ábrela en HubSpot y confírmalo.
### Escribí mal el nombre de la variable
Usa el botón de copiar del bloque en el lienzo en vez de escribirla a mano. Copia exactamente el nombre, con las llaves incluidas.
### No encuentro la propiedad que quiero leer
Actualiza las propiedades con el botón de sincronizar. Revisa
# Bloque de Transferencia Humana
Source: https://help.treble.ai/es/docs/integrations/hubspot/blocks/human-transfer
Aprende en esta guía cómo usar el bloque de transferencia humana en Treble. Este bloque permite que tus conversaciones sean transferidas a un agente humano. Tu equipo de agentes podrá responder a estas conversaciones directamente desde HubSpot.
# Transferencia a humano
Esta funcionalidad es clave a la hora de querer transferir la conversación a un agente. A medida que construyas la conversación, si en algún punto deseas que la reciba un agente, debes seleccionar "transferencia a humano" y elegir el grupo al cual deseas transferir.
## ¿Cómo se utiliza el bloque de transferencia humana?
1. Inicia sesión en Treble.ai en:
2. Dirígete a **Crear Conversación**
3. Has click en el botón de para desplegar el menú de bloques
4. Has scroll hasta encontrar el menú de **Transferencia a humano** y adentro, selecciona el bloque de **Transferencia a agente en HubSpot**
5. Has click en el bloque de **Transferencia a agente en HubSpot** para agregarlo a tu conversación
6. Mueve el bloque de **Transferencia a agente en HubSpot** a la posición que desees en tu flujo
7. Conecta el bloque de **Transferencia a agente en HubSpot** con el bloque de **Pregunta**
8. Una vez hayas agregado el bloque de **Transferencia a agente en HubSpot**, has doble click en el bloque para desplegar el menú de configuración
9. Podrás seleccionar el equipo al que deseas transferir la conversación
Esta guía contiene los pasos específicos para configurar el bloque de transferencia humana en Treble relacionado con HubSpot. Sin embargo, antes de continuar, te recomendamos leer la guía de Bloque de Transferencia a Agente de Treble dado que los conceptos como Equipos, Agentes, etc. son los mismos para ambos bloques.
Conoce más sobre el bloque de transferencia humana en Treble y entiende conceptos como Equipos, Agentes y Métodos de Asignación.
Con el bloque de **Métodos de transferencia** puedes elegir si el chat se asigna al agente propietario del contacto —de inmediato, con un tiempo límite de espera o solo si está conectado— o a un equipo, y definirlo por conversación.
Una vez hayas configurado el bloque de transferencia humana, tu equipo de agentes podrá responder a estas conversaciones directamente desde HubSpot. Para ello, debes seguir los siguientes pasos:
1. Inicia sesión en HubSpot
2. Dirígete a **Bandeja de entrada**
3. Busca "WhatsApp" en la barra lateral izquierda
4. Al hacer click en "WhatsApp", verás las conversaciones transferidas a tu equipo como agente
¡Listo! Ahora tus agentes podrán responder a las conversaciones transferidas a su equipo directamente desde HubSpot.
# Bloque de Ticket
Source: https://help.treble.ai/es/docs/integrations/hubspot/blocks/ticket
Aprende a utilizar el bloque de ticket de Treble. Este bloque te permite crear un ticket en HubSpot en función de la respuesta del cliente. Puedes configurar el ticket con múltiples propiedades.
# Tickets de HubSpot desde Treble
Puedes gestionar la creación de tickets en HubSpot automáticamente desde Treble. Para ello, debes seleccionar la opción "Creación de ticket" en el selector de bloques. Cuando un usuario pase por ese bloque en una conversación, se creará un ticket en HubSpot, el cual quedará asociado con la sesión actual del usuario. Si el usuario pasa por un bloque de ticket de HubSpot cuando ya hay un ticket asociado a la sesión, en lugar de crear uno nuevo, el ticket existente se actualizará con los atributos especificados.
## ¿Cómo se utiliza?
1. Inicia sesión en Treble.ai en:
2. Dirígete a **Crear Conversación**
3. Has click en el botón de para desplegar el menú de bloques
4. Has scroll hasta encontrar el bloque de **Creación de Ticket**
5. Has click en el bloque de **Creación de Ticket** para agregarlo a tu conversación
6. Mueve el bloque de **Creación de Ticket** a la posición que desees en tu flujo
7. Conecta el bloque de **Creación de Ticket** con el bloque de **Pregunta**
8. Una vez hayas agregado el bloque de **Creación de Ticket**, has doble click en el bloque para desplegar el menú de configuración
## Configuración de propiedades de los tickets
Puedes establecer los valores de las propiedades asociadas al ticket haciendo click en el bloque. Algunas propiedades no están disponibles para configuración, como los atributos de tipo fecha y las propiedades que enlazan a un usuario de HubSpot, como `Propietario del ticket`. Estos valores se establecerán automáticamente cuando se cree el ticket. El atributo `Creado en` se asignará automáticamente en cuanto se genere el ticket.
Cuando se actualiza un ticket y no se ha definido un valor para un atributo en el bloque del ticket, dicho atributo no cambiará ni se establecerá en un valor vacío.
[Treble.ai](http://treble.ai/) agregará automáticamente la opción `WhatsApp` al atributo `Fuente` en la plataforma de HubSpot. Esta opción estará preseleccionada por defecto al crear este tipo de bloques.
Otra propiedad que [Treble.ai](http://treble.ai/) crea automáticamente es `Treble Rating`, donde almacenará la respuesta del usuario a la encuesta CSAT al finalizar la conversación.
Todas las propiedades de tipo texto tendrán la opción de personalizar el valor utilizando propiedades del contacto. Para ello, basta con hacer clic en el icono al final del campo de entrada.
## Cierre de una conversación
Cuando un usuario cierra una conversación en la aplicación de helpdesk, la plataforma mostrará un modal que permitirá seleccionar a dónde mover el ticket de HubSpot (pipeline y etapa) una vez cerrada la conversación. [Treble.ai](http://treble.ai/) recordará la última opción seleccionada al cerrar una conversación.
En los siguientes casos, cuando el chat se cierre, [Treble.ai](http://treble.ai/) buscará en qué pipeline se encuentra el ticket y lo moverá automáticamente a una etapa de tipo **cerrado**. Si hay múltiples etapas de este tipo en el pipeline, seleccionará la primera.
* En la aplicación de helpdesk, si la empresa tiene configurada la opción de cerrar automáticamente una conversación tras un periodo de inactividad.
* Si el usuario utiliza la opción "Cerrar todos los chats".
* Si la conversación nunca llegó a un sistema de helpdesk y el usuario llegó al final de la conversación, o si la conversación se cerró automáticamente por inactividad.
# Historial de Chat en HubSpot como Notas
Source: https://help.treble.ai/es/docs/integrations/hubspot/features/chat-history
Las conversaciones con tus clientes ahora se registran como Notas en su contacto de HubSpot, para que el historial completo del chat esté visible sin salir de HubSpot.
# Historial de Chat en HubSpot como Notas
Las conversaciones que inicias con tus clientes ahora pueden crear una Nota única para ellos en su contacto de HubSpot. Esto le da a tu equipo de ventas y soporte el historial completo del chat directamente dentro de HubSpot, sin cambiar de herramienta.
## Cómo funciona
* Cuando comienza una conversación nueva, ya sea desde una campaña o desde el agente, se crea una Nota para esa conversación en curso.
* La Nota se actualiza a medida que la conversación avanza, tanto del lado del cliente como del lado del agente o la IA.
* Si el cliente ya tiene una conversación en curso abierta, no se crea una Nota nueva. En su lugar, se sigue actualizando la Nota existente.
Esto aplica a cualquier conversación que tenga un contacto de HubSpot asociado, sin importar si comenzó desde una campaña, un mensaje entrante o el agente de IA.
## Preguntas frecuentes
No. Todos los mensajes de la misma conversación en curso se registran en una sola Nota, que se sigue actualizando a medida que la conversación avanza.
Una vez que la conversación en curso termina, la siguiente conversación con ese cliente crea una Nota nueva.
No. Esto funciona automáticamente para cualquier cuenta que tenga la integración de HubSpot conectada.
# Desplegar Conversación desde Perfil de Contacto
Source: https://help.treble.ai/es/docs/integrations/hubspot/features/deploy
Aprende a desplegar conversaciones de Treble directo desde la vista de Contacto dentro de HubSpot.
Para que el botón de desplegar conversación esté disponible, debes hacer instalado la extensión de Treble para Chrome. Si no tienes la extensión, conoce como hacerlo aqui:
# Enviar una Conversación de Treble desde HubSpot a un Contacto
Además de hacer envíos masivos mediante Workflows de HubSpot, Treble también tiene la funcionalidad de hacer envíos individuales desde el perfil del cliente en HubSpot.
Para realizar un envío a una persona, primero debes dirigirte al perfil del cliente al que deseas contactar.
Dentro del perfil encontrarás el icono de Treble. Lo único que debes hacer es darle clic, seleccionar la conversación que quieres enviar y hacer clic en desplegar.
Recuerda que únicamente podemos enviar conversaciones outbound. Aunque en ese ícono encontrarás TODAS las conversaciones, solamente podrás hacer envío de conversaciones outbound.
# Actualizaciones de Estado de HSM como Actividades en la Línea de Tiempo
Source: https://help.treble.ai/es/docs/integrations/hubspot/features/hsm-status
Los HSM enviados a clientes con un contacto de HubSpot ahora crean actividades en la línea de tiempo que indican si fueron enviados, entregados o fallaron.
# Actualizaciones de Estado de HSM como Actividades en la Línea de Tiempo
Ahora, al enviar HSM desde cualquier lugar de Treble a clientes que tienen un contacto de HubSpot, esos clientes reciben nuevas actividades en la línea de tiempo que indican el estado de ese HSM.
## Estados que se rastrean
| Actividad | Qué significa |
| ----------------- | ------------------------------------------------------ |
| **HSM enviado** | Treble envió el HSM exitosamente a Meta. |
| **HSM entregado** | Meta recibió y entregó el HSM al WhatsApp del cliente. |
| **HSM fallido** | Ocurrió un error de Treble o de Meta al enviar el HSM. |
Esto aplica a los HSM enviados desde cualquier origen, campañas, bloques de conversación o la API, siempre que el cliente tenga un contacto de HubSpot asociado.
## Preguntas frecuentes
Solo a los HSM. Los mensajes de sesión no se reflejan como actividades en la línea de tiempo.
No se crea ninguna actividad en la línea de tiempo. El cliente necesita tener un contacto de HubSpot asociado para que se registre la actividad.
No. Esto funciona automáticamente para cualquier cuenta que tenga la integración de HubSpot conectada.
# Propiedades de HubSpot en Treble
Source: https://help.treble.ai/es/docs/integrations/hubspot/features/properties
Por qué a veces no ves una propiedad recién creada y cómo actualizar la lista de propiedades de HubSpot dentro de Treble.
# Propiedades de HubSpot en Treble
Cuando configuras un bloque que escribe o lee información en HubSpot, Treble te muestra la lista de propiedades de tu cuenta para que elijas una. Esta página explica de dónde sale esa lista y qué hacer cuando la propiedad que buscas no aparece.
## Treble guarda una copia de tus propiedades
Antes, Treble le preguntaba a HubSpot por tus propiedades cada vez que abrías un bloque. Eso funcionaba, pero generaba muchísimas peticiones hacia HubSpot, y HubSpot limita cuántas puede recibir una cuenta.
Desde septiembre de 2026, Treble **guarda una copia de tus propiedades** y trabaja sobre ella. Esto trae dos cosas:
* **La configuración es más rápida** y no consume el límite de peticiones de tu cuenta de HubSpot.
* **Los cambios que haces en HubSpot no aparecen solos.** Si creas una propiedad nueva, o le agregas una opción a un desplegable, Treble sigue mostrando la copia anterior hasta que la actualices.
Esto afecta únicamente a la **lista de propiedades** que ves al configurar. Los **valores** de tus contactos y objetos siempre se leen y se escriben en HubSpot, nunca de una copia.
## Actualizar la lista de propiedades
Cuando no encuentres una propiedad, usa el botón de sincronizar. Vas a encontrarlo en los distintos lugares donde Treble te muestra propiedades de HubSpot:
* En el bloque de **Acción en CRM**
* En el bloque **Objeto CRM**
* En las herramientas de HubSpot del **Agente de IA**
* En la configuración de **propiedades de contacto** dentro de Sales
* En el **constructor de plantillas de mensaje**
* En la configuración de **enrutamiento por propiedad**
Al hacer clic, Treble vuelve a pedirle a HubSpot la lista completa y reemplaza la copia. Tarda unos segundos. Después de eso, la propiedad nueva ya aparece en el selector.
Si acabas de crear una propiedad en HubSpot y no la ves en Treble, esta es casi siempre la solución. Actualiza y vuelve a buscarla antes de reportarlo como un error.
## Cuándo necesitas actualizar
Actualiza la lista después de hacer cualquiera de estos cambios en HubSpot:
| Cambio en HubSpot | ¿Requiere actualizar? |
| ---------------------------------------------------- | --------------------- |
| Crear una propiedad nueva | Sí |
| Agregar o quitar opciones de un desplegable | Sí |
| Cambiar el nombre visible de una propiedad | Sí |
| Eliminar una propiedad | Sí |
| Cambiar el **valor** de una propiedad en un contacto | No |
| Crear un contacto, negocio o ticket nuevo | No |
## Preguntas frecuentes
Usa el botón de sincronizar en el mismo lugar donde estás buscando la propiedad. Treble volverá a traer la lista completa desde HubSpot.
Es el mismo caso. Las opciones de los desplegables también forman parte de la copia, así que necesitan una actualización.
No. La actualización solo refresca la lista de propiedades disponibles. No modifica ningún valor en HubSpot ni en tus conversaciones ya publicadas.
No. La copia es una sola para toda tu cuenta de Treble. Si actualizas desde el bloque de Acción en CRM, la lista queda actualizada también en el Agente de IA, en Sales y en las plantillas.
Solo cuando cambies la estructura de tus propiedades en HubSpot. No es algo que necesites hacer de forma periódica.
# Variables
Source: https://help.treble.ai/es/docs/integrations/hubspot/features/variables
Esta guía te muestra cómo poder actualizar y usar propiedades de tus contactos de HubSpot dentro de tus conversaciones de Treble. Esto te permitirá crear conversaciones más personalizadas y automatizadas.
# Variables - Actualizar Propiedades en HubSpot a través de una Conversación de Treble
Por medio de la integración de Treble con HubSpot, puedes actualizar y usar propiedades de tus contactos de HubSpot dentro de tus conversaciones de Treble. Miremos un ejemplo para entender cómo funciona. Supongamos que tienes la siguiente conversación en Treble:
En esta conversación estás pidiendo algunos datos: el nombre y el correo. A través de la integración Treble-HubSpot, podemos guardar las respuestas de los clientes dentro de variables de HubSpot.
Para guardar una respuesta, haz doble clic en el cuadro de texto y selecciona "Guardar Respuesta"
Luego debes seleccionar el "tipo de respuesta" según lo que esperas recibir del cliente. En el campo "nombre de la variable" debes colocar el nombre interno de la propiedad.
El "Nombre de la variable" es el prefijo `hubspot_` seguido del nombre interno de la propiedad en HubSpot. Por ejemplo, si el nombre interno de la propiedad es `name`, el nombre de la variable será `hubspot_name`.
## Valor Interno de la Variable - Propiedad de HubSpot
**¿Qué es el valor interno de propiedades?** Es el valor que Treble utiliza para identificar dónde debe buscar y/o almacenar información en HubSpot.
Para poder buscar el valor de una propiedad, sigue los siguientes pasos:
1. Accede e inicia sesión en HubSpot
2. Haz clic en el botón de Configuración en la esquina superior derecha dentro
3. Has scroll en el panel de la izquierda hasta encontrar la sección de "Manejo de datos"
4. Selecciona "Propiedades"
5. En propiedades, puedes buscar el valor de la propiedad por medio del nombre interno de la propiedad. En este ejemplo, estamos buscando el valor de la propiedad `country`.
6. Has click en la propiedad que quieres buscar.
Vas a encontrar el valor de la propiedad en la sección de "Nombre interno"
Como puedes ver, el valor interno de la propiedad `country` es `country`. Por lo tanto, si deseas hacer cambios en el pais de un contacto de HubSpot por medio de sus respuesta en una conversación de Treble, el nombre de la variable será `hubspot_country`.
Aunque en este ejemplo, el valor interno de la propiedad es el mismo que el nombre de la propiedad, esto no siempre será el caso. Por ejemplo, para la propiedad `firstname` el nombre interno de la propiedad es `firstname`. Por lo tanto, el nombre de la variable para usar en Treble será `hubspot_firstname`.
¡Perfecto! Ya sabes ahora como usar variables de HubSpot dentro de tus conversaciones de Treble. De esta forma, cuando el cliente pase por este bloque y responda la pregunta que deseas guardar, la respuesta quedará reflejada en su contacto dentro de HubSpot.
Las variables `hubspot_` que se describen en esta página corresponden a **propiedades de contacto**, y quedan disponibles automáticamente en toda la conversación.
Treble también puede escribir y leer propiedades de **negocios, empresas y tickets**. Eso se hace desde bloques específicos y no a través de variables `hubspot_`:
* Para **escribir** en esos objetos:
## ¿Cómo puedo usar las variables de HubSpot en mis conversaciones?
Dado que ya conoces la estructura de las variables de Treble relacionadas con HubSpot, puedes tambien usar estas variables en cualquier bloque de tu conversación para usar la información que ya tienes en HubSpot. Por ejemplo, supongamos que tienes el siguiente Contacto en HubSpot:
| Propiedad | Valor | Nombre Interno (HubSpot) |
| ------------------- | ---------- | ------------------------ |
| Nombre | Juan | firstname |
| Celular | 3123456789 | phone |
| Fecha última compra | 2025-03-28 | last\_purchase\_date |
Podamos usar las propiedades de este contacto en cualquier bloque de tu conversación. Por ejemplo, puedes usar la propiedad `firstname` para saludar al cliente por su nombre. Adicionalmente, puedes usar la propiedad `last_purchase_date` para preguntarle sobre su última compra.
Dado el nommbre interno de la variable de HubSpot, volvamos a revisar la tabla anterior y reemplazamos el nombre interno de la propiedad por el nombre de la variable.
| Propiedad | Valor | Nombre Interno (HubSpot) | Nombre de la Variable (Treble) |
| ------------------- | ---------- | ------------------------ | ------------------------------ |
| Nombre | Juan | firstname | hubspot\_firstname |
| Celular | 3123456789 | phone | hubspot\_phone |
| Fecha última compra | 2025-03-28 | last\_purchase\_date | hubspot\_last\_purchase\_date |
Ahora podemos usarlas en cualquier bloque de tu conversación. Solo debemos agregarlas encapsuladas entre llaves `{{}}`. Por ejemplo, para saludar al cliente por su nombre, podemos usar la variable `{{hubspot_firstname}}`.
# Workflows
Source: https://help.treble.ai/es/docs/integrations/hubspot/features/workflows
Aprende a crear workflows en HubSpot para automatizar el envío de tus conversaciones de Treble y WhatsApp.
# Workflows de HubSpot
En Treble, las conversaciones dentro de Workflows en HubSpot son una herramienta esencial para automatizar y personalizar la comunicación con clientes y leads. Al integrar estas conversaciones, puedes crear interacciones automáticas basadas en acciones específicas de los usuarios, asegurando una atención rápida y eficiente. Esto no solo mejora la experiencia del cliente, sino que también optimiza tus procesos internos para aumentar la productividad y las conversiones.
## Usa los workflows de HubSpot para automatizar los envíos de conversaciones
* Crea workflows basados en contactos, empresas o negocios y utiliza los desencadenantes que prefieras
* Programa el envío de mensajes basado en una propiedad de contacto, como la fecha de cumpleaños o la fecha de cierre del negocio, utilizando el tipo de workflow “Propiedad de fecha de contacto”
## Cómo desplegar una conversacion de Whatsapp (treble) por Workflows de HubSpot
Lo primero que debes de hacer es ir a Hubspot → Automatizaciones → Workflows
Al seleccionar Workflows puedes crear uno desde cero.
Los workflows se pueden crear para contactos, negocios, tickets y otros elementos.
Al hacer clic en el cuadro de texto, aparece una barra lateral izquierda. Allí podemos seleccionar "Cuando se cumplen los criterios del filtro". Esta opción nos permite crear reglas basadas en los valores de las propiedades.
A continuación, seleccionamos todas las propiedades que determinan los criterios que deben cumplir los clientes para hacer un envío. Cuando tengamos los criterios listos, debemos hacer clic en el icono del
Lo que queda ahora es seleccionar la acción de Treble, elegir la conversación que queremos enviar y especificar el número desde el cual se realizará el envío.
1. Al hacer click en el botón de , se desplegará un panel a la izquierda con la lista de acciones.
2. Has scroll hasta encontrar la sección de "Aplicaciones Integradas"
3. Selecciona la opción de "Treble: WhatsApp Integration"
4. Una vez hagas click en la opción, se desplegarán dos campos:
* "Conversación": Selecciona la conversación de Treble que quieres que se envie. Esta conversación debe estar creada en Treble.
Las conversaciones en Treble son flujos de mensajes que puedes crear para automatizar el envío de mensajes a tus clientes. Si no conoces cómo crear una conversación, puedes consultar el siguiente artículo:
* "Número": En Treble, puedes tener múltiples números de WhatsApp. Selecciona el número al que quieres que se envíe la conversación.
5. Darle click en "Guardar" para finalizar la configuración del workflow.
Confirma que el workflow está listo y haz clic en "Guardar" para finalizar la configuración. Puedes ver la siguiente imagen para entender cómo se vería el workflow en HubSpot.
Como paso final, puedes publicar el workflow para que se ejecute haciendole click en el botón de "Revisar y Publicar"
¡Felicitaciones! Has creado tu primer workflow en HubSpot para desplegar una conversación por WhatsApp con Treble.
RECUERDA: Los workflows sirven para enviar mensajes masivos, como para enviar mensajes automatizados.
# Ejemplos de uso de la integración de HubSpot con IA
Source: https://help.treble.ai/es/docs/integrations/hubspot/hubspot-ai/examples
Esta guía te algunas recetas de escenarios y casos de uso de la integración de Treble con HubSpot.
Este artículo muestra un escenario real para usar HubSpot con Treble desde un agente de IA: validar si el cliente ya existe en el CRM como Contacto, crearlo si no existe, actualizar sus datos, crear un negocio (Deal / Oportunidad) y transferir la conversación a un agente humano.
## Escenario práctico: calificación y handoff a ventas
Imagina que tus clientes te escriben por WhatsApp para pedir información comercial. Tu objetivo es automatizar este flujo:
1. Revisar si el cliente ya está registrado en HubSpot como **Contacto**.
2. Si no existe, crearlo en HubSpot y registrar los datos básicos.
3. Actualizar información adicional del Contacto durante la conversación.
4. Crear un **Negocio (Deal / Oportunidad)** con información de cotización.
5. Transferir la conversación a un agente humano en Treble.
## Herramientas que intervienen
En este escenario puedes combinar herramientas como:
* Búsqueda de Contacto por teléfono.
* `create_crm_contact` para registrar al cliente.
* `update_crm_contact` para completar campos faltantes.
* `create_crm_deal` para crear la oportunidad comercial.
* `transferToAgent` para handoff al equipo humano.
## Prompt recomendado (ejemplo completo)
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en HubSpot antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Contacto por teléfono usando:
\[PLACEHOLDER\_TOOL\_CALL\_SEARCH\_CONTACT\_BY\_PHONE]
2. Si no existe Contacto, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Contacto usando:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_CONTACT]
3. Si el Contacto ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
\[PLACEHOLDER\_TOOL\_CALL\_UPDATE\_CONTACT]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
\[PLACEHOLDER\_TOOL\_CALL\_TRANSFER\_TO\_AGENT]
### Reglas de comportamiento
* Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
* No inventes datos: solo guarda en CRM lo confirmado por el cliente.
* Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
* Si detectas que el cliente ya existe, continúa el flujo sobre ese mismo Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```text theme={null}
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en HubSpot antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Contacto por teléfono usando:
[PLACEHOLDER_TOOL_CALL_SEARCH_CONTACT_BY_PHONE]
2. Si no existe Contacto, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Contacto usando:
[PLACEHOLDER_TOOL_CALL_CREATE_CONTACT]
3. Si el Contacto ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
[PLACEHOLDER_TOOL_CALL_UPDATE_CONTACT]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
[PLACEHOLDER_TOOL_CALL_CREATE_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
[PLACEHOLDER_TOOL_CALL_TRANSFER_TO_AGENT]
### Reglas de comportamiento
- Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
- No inventes datos: solo guarda en CRM lo confirmado por el cliente.
- Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
- Si detectas que el cliente ya existe, continúa el flujo sobre ese mismo Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```
## Recomendaciones para adaptar este ejemplo
* Ajusta nombres de campos (`slug`) según tus propiedades reales en HubSpot.
* Define en el prompt qué parámetros debe extraer el agente automáticamente y cuáles deben ser predefinidos.
* Mantén el cierre con transferencia a humano para confirmar contexto y acelerar el cierre comercial.
Este patrón aplica para múltiples casos: captación de contactos, calificación comercial, actualización de CRM y handoff a equipos humanos.
# Funcionalidades de la integración de HubSpot con IA
Source: https://help.treble.ai/es/docs/integrations/hubspot/hubspot-ai/features
Esta guía te muestra cómo usar las funcionalidades de la integración de Treble con HubSpot.
La integración de HubSpot con Treble te permite interactuar con múltiples entidades en HubSpot desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline.
Con estas entidades, las herramientas de la integración te permiten ejecutar distintas acciones según el tipo de entidad. En Contacto, Empresa (Company) y Negocio (Deal / Oportunidad) puedes crear, actualizar, eliminar, listar y consultar registros individuales. En Pipeline puedes consultar uno, listar varios o eliminar.
# Acciones disponibles por entidad
## Contacto
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo contacto en HubSpot, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un contacto existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un contacto existente en HubSpot. |
| *List* | Listar múltiples contactos según los filtros disponibles. |
| *Get* | Consultar un contacto específico por su identificador. |
## Empresa (Company)
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------------------------------------- |
| *Create* | Crear una nueva empresa en HubSpot, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar una empresa existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar una empresa existente en HubSpot. |
| *List* | Listar múltiples empresas según los filtros disponibles. |
| *Get* | Consultar una empresa específica por su identificador. |
## Negocio (Deal / Oportunidad)
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------------------------------------ |
| *Create* | Crear un nuevo negocio en HubSpot, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un negocio existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un negocio existente en HubSpot. |
| *List* | Listar múltiples negocios según los filtros disponibles. |
| *Get* | Consultar un negocio específico por su identificador. |
## Pipeline
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------ |
| *Remove* | Eliminar un pipeline existente en HubSpot. |
| *List* | Listar múltiples pipelines disponibles. |
| *Get* | Consultar un pipeline específico por su identificador. |
# ¿Cómo usar las herramientas de Treble para HubSpot?
La integración de HubSpot con Treble hace uso de el asistente de IA "Automatizar tareas complejas" para ejecutar las acciones de las herramientas de Treble para HubSpot. Para ello, es indispensable que sepas cómo usar el asistente de IA "Automatizar tareas complejas" en Treble y cómo configurar las herramientas de Treble para HubSpot.
Si necesitas más información sobre cómo usar el asistente de IA "Automatizar tareas complejas" en Treble, puedes consultar la documentación de "Automatizar tareas complejas" en Treble en el siguiente enlace:
Aprende a usar el asistente de IA "Automatizar tareas complejas" en Treble.
# Configuración de las herramientas de Treble para HubSpot
Para configurar las herramientas de Treble para HubSpot, debes seguir los siguientes pasos:
1. Ingresa a la sección de "Agentes de IA" en Treble.
2. Crea un nuevo agente de IA.
3. Selecciona la opción de "Automatizar tareas complejas".
4. En la sección de "Herramientas", selecciona la herramienta de "Aplicaciones Conectadas".
5. En la sección de "Aplicaciones Conectadas", selecciona la aplicación de "HubSpot".
6. En la sección de "Herramientas", selecciona la herramienta de "HubSpot" que deseas configurar.
Este proceso es el mismo para todas las herramientas listadas de Treble para HubSpot. Sin embargo, cada herramienta tiene sus propias configuraciones. Explicaremos las configuraciones de cada herramienta a continuación.
## Herramienta Buscar Contacto por Teléfono
Dentro de las herramientas listadas de Treble para HubSpot, existe la herramienta "Buscar Contacto por Teléfono". Esta herramienta te permite buscar Contactos por teléfono. La herramienta automáticamente busca el Contacto en HubSpot según el teléfono de WhatsApp del cliente que está interactuando con tu asistente de IA por medio de una línea de WhatsApp conectada a Treble. No es necesario que tu asistente de IA tenga que preguntar por el teléfono del cliente, la herramienta lo hará automáticamente.
Has click en la opción de buscar Contacto por teléfono. Una vez hayas dado click, esta herramienta no tiene más configuraciones, en los siguientes dos pasos has click en "Siguiente Paso" y finalmente has click en "Guardar Configuración". Verás la herramienta añadida dentro de las instrucciones de tu asistente de IA.
### Formato del teléfono en HubSpot y propiedades
Treble utiliza el formato de teléfono internacional para buscar Contactos en HubSpot. Por ejemplo, si el teléfono del cliente es del país Estados Unidos y el teléfono es `(917) 555-0111`, Treble lo buscará en HubSpot como `+19175550111`. Treble hará la búsqueda dentro de la propiedad `Phone` en HubSpot.
Ten en cuenta que, en ultimas, el agente de IA es quien decide en qué formato realizar la busqueda. Por defecto, el agente intentará buscar en formato internacional. Sin embargo, si en tu HubSpot los telefonos no están guardados en formato internacional, puedes indicarle al agente dentro de sus instrucciones (prompt) qué formato debe usar para hacer la busqueda.
Ejemplos de instrucciones para el agente de IA:
* Colombia: "Cuando uses la herramienta de buscar Contacto por telefono, busca primero en formato local de Colombia (por ejemplo, `3001234567`) y, si no encuentras resultados, intenta en formato internacional (`+573001234567`)."
* Argentina: "Cuando busques por telefono en HubSpot, prioriza formato local de Argentina (por ejemplo, `1151234567` o `3515123456`). Si no hay coincidencias, intenta formato internacional (`+541151234567` o `+543515123456`)."
* Brasil: "Para buscar Contactos por telefono, usa primero formato local de Brasil (por ejemplo, `11987654321`). Si no hay resultados, prueba tambien formato internacional (`+5511987654321`)."
## Herramientas con Opciones de Configuración
Para las demás herramientas, como Crear Contacto, Actualizar Contacto, Crear Empresa, Crear Negocio, Buscar (Get) un Pipeline, etc., estas herramientas tienen opciones de configuración. Estas opciones de configuración te permiten interactuar con propiedades de esas entidades. Estas propiedades pueden ser estándar o personalizadas. Miremos algunos ejemplos de configuraciones de herramientas.
### Ejemplo Crear Contacto
La herramienta "Crear Contacto" te permite crear un nuevo contacto en HubSpot. Para configurar esta herramienta, debes seguir los siguientes pasos:
1. Activa la vista de herramientas de HubSpot dentro de la sección de "Herramientas" de tu asistente de IA.
2. Has click en la herramienta de "Create CRM Contact".
3. En esta vista selecciona las propiedades que deseas configurar para el contacto. Puedes seleccionar propiedades estándar o personalizadas. En este ejemplo, vamos a seleccionar las propiedades "Name", "Emails", "Telephone" y "Address".
4. Haz click en "Siguiente Paso". En la vista "Parámetros manejados por Agente IA" debes seleccionar qué propiedades quieres que el agente de IA complete dinámicamente durante la conversación.
Cuando una propiedad está marcada como "manejada por Agente IA", el agente intentará extraer ese valor del contexto del chat (por ejemplo, nombre, email o teléfono). Si no encuentra el dato con suficiente claridad, hará una pregunta al cliente para completarlo antes de ejecutar la herramienta.
Para obtener mejores resultados, define instrucciones explícitas en el prompt del agente sobre qué campos debe recopilar y cómo debe hacerlo. Ejemplo recomendado: "Cuando uses la herramienta Crear Contacto, intenta extraer `Name`, `Emails` y `Telephone` del contexto de la conversación. Si falta alguno, solicítalo al cliente de forma breve y luego crea el Contacto."
En esta vista marca solo los campos variables. Los campos que quieras fijar con un valor predefinido (por ejemplo, `Address = Calle 123, Ciudad`) puedes dejarlos sin seleccionar aquí y configurarlos en la siguiente sección.
En este caso vamos a seleccionar las propiedades "Name", "Emails" y "Telephone". (Dejamos sin seleccionar la propiedad "Address" para configurarla manualmente en la siguiente sección.)
5. En la siguiente vista, vamos a configurar los campos donde el Contacto se debería crear con algunas propiedades predefinidas. Por ejemplo, si todos tus contactos operan en la misma ciudad y quieres registrar la dirección de forma manual, puedes escribir en el campo "Address" el valor fijo que corresponda, como `Calle 123, Ciudad`. Esto lo puedes configurar con múltiples propiedades, es decir, puedes configurar varias propiedades con un valor predefinido, lo importante es no seleccionarlas dentro de la vista "Parámetros manejados por Agente IA".
¡Felicitaciones! Ya has configurado la herramienta Crear Contacto.
# Conclusiones Finales
Este ejemplo de configuración de la herramienta **Crear Contacto** y de sus parámetros aplica de forma idéntica para las demás herramientas de HubSpot y sus opciones de configuración. La lógica es la misma: definir qué propiedades se completan con datos extraídos por el agente de IA, cuáles se dejan como valores predefinidos y cómo se ejecuta la acción según la entidad. Esto aplica en casos como **List Pipeline**, **Get Contact**, **Update Deal**, **Create Company**, entre otros.
# Instalación de la integración de HubSpot con IA
Source: https://help.treble.ai/es/docs/integrations/hubspot/hubspot-ai/installation
Esta guía te muestra cómo instalar la integración de Treble con HubSpot.
Para instalar la integración de tu producto con HubSpot, es crucial que el usuario tenga permisos de administrador en la cuenta de HubSpot.
# Pasos para instalar la integración de HubSpot en Treble
1. Inicia sesión en
2. Dirígete a Configuración
3. Dirígete a Integraciones
4. Haz clic en la pestaña de "Aplicaciones Conectadas"
En este punto vamos a seguir las instrucciones. Has click en el botón de "Conectar Aplicación" y se te abrirá un modal con las opciones de conexión. Has click en "HubSpot".
Al hacer clic en "HubSpot", se abrirá la pantalla **Seleccionar cuenta**, donde verás la lista de cuentas de HubSpot disponibles asociadas a tu usuario. Selecciona la cuenta a la que deseas conectar Treble y haz clic en **Choose Account**.
A continuación, HubSpot mostrará los permisos que la integración **Integración de WhatsApp** solicita sobre tu cuenta. Estos permisos incluyen gestionar y visualizar datos del CRM (contactos, negocios, empresas), información básica de la cuenta, tickets y eventos de línea de tiempo. Revisa los permisos y haz clic en **Connect app** para completar la autorización. Si deseas cancelar, haz clic en **Cancel**.
Ya conectaste la aplicación de HubSpot en Treble.
Ahora puedes usar las herramientas de HubSpot para la IA en Treble. Para ello, ve a la sección de "Agentes de IA" y crea un nuevo agente de IA. Debes seleccionar la opción de "Automatizar tareas complejas". Después de crear el agente, ve a la sección de "Herramientas" y selecciona en la lista de herramientas la opción de "Aplicaciones Conectadas". En esta sección, selecciona la aplicación de "HubSpot" y verás las herramientas disponibles para usar en la IA.
¡Felicitaciones! Ya lograste instalar la integración de HubSpot en Treble.
En la siguiente sección, te explicamos cómo usar las herramientas de HubSpot para la IA en Treble.
# Integración de HubSpot con IA
Source: https://help.treble.ai/es/docs/integrations/hubspot/hubspot-ai/welcome
Esta guía te muestra cómo integrar Treble con HubSpot y la funcionalidad de IA
Treble te ayuda a aprovechar todo el potencial de WhatsApp para vender más de forma integrada con HubSpot y con IA. La integración de HubSpot AI te permite conectar HubSpot con Treble para actualizar y consultar información de tus entidades en HubSpot desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline.
## Funcionalidades
1. Actualizar información de tus entidades en HubSpot
* Puedes actualizar información de Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline en HubSpot, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
2. Obtener información de tus entidades para usar en tus conversaciones en Treble
* Puedes obtener información de Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline para usar en tus conversaciones en Treble, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
3. Crear entidades en HubSpot
* Puedes crear Contactos, Empresas (Company) y Negocios (Deal / Oportunidad) en HubSpot con propiedades estándar y personalizadas.
4. Eliminar entidades en HubSpot
* Puedes eliminar Contactos, Empresas (Company) y Negocios (Deal / Oportunidad) en HubSpot.
## Ejemplos de uso
1. Tus clientes te contactan por WhatsApp, nuestro asistente de IA responde preguntas frecuentes de tus clientes, revisa si el Contacto existe en HubSpot, si no, lo crea y transfiere la conversación a un agente de tu equipo en Treble.
2. Tu cliente quiere actualizar información de su cuenta, el agente de IA puede hacer las preguntas necesarias para actualizar datos del Contacto en HubSpot.
3. Tu cliente te contacta porque necesita ayuda con su potencial compra de un producto, el agente de IA puede revisar el Negocio (Deal / Oportunidad) en HubSpot y actualizar su estado e información.
4. Tu equipo comercial necesita visibilidad del avance de ventas, el agente de IA puede consultar el Pipeline en HubSpot para identificar en qué etapa está cada Negocio y guiar la siguiente acción en la conversación.
# Instalar Treble en HubSpot
Source: https://help.treble.ai/es/docs/integrations/hubspot/install
En esta guía aprende cómo integrar Treble con HubSpot. Esto es algo que solo tienes que hacer una vez. Una vez configurado, Treble te ayudará a aprovechar todo el potencial de WhatsApp para vender más a través de tu integración.
Para instalar la integración de tu producto con HubSpot, es crucial que el usuario tenga permisos de administrador en la cuenta de HubSpot.
Para verificar si tienes los permisos necesarios, inicia sesión en tu cuenta de HubSpot y dirígete a la sección de "Configuración" (representada por un ícono de engranaje en la esquina superior derecha). Luego, selecciona "Usuarios y Equipos" en el menú de la izquierda. Aquí podrás ver una lista de usuarios y sus roles. Asegúrate de que tu rol esté marcado como "Administrador". Si no tienes este rol, contacta al administrador de tu cuenta de HubSpot para que te otorgue los permisos necesarios.
# Pasos para instalar la integración de Treble en HubSpot
1. Inicia sesión en
2. Dirígete a Configuración
3. Dirígete a Integraciones
4. Haz clic en "Habilitar" en la sección de HubSpot
En este punto vamos a seguir las instrucciones. El primer paso nos indica instalar la aplicación de Treble en HubSpot. Primero, asegúrate que has iniciado sesión en tu cuenta de HubSpot. Luego, haz clic donde dice "Instalar aquí"
Ahora debes escoger la empresa que deseas integrar con Treble. Al seleccionar la cuenta, aparecerá un mensaje de bienvenida a Treble. En este momento sabrás que la conexión fue exitosa.
Es normal que al seleccionar tu compañía, la plataforma solicite que inicies sesión nuevamente en HubSpot. Si esto ocurre, simplemente haz clic en el icono de Treble e ingresa tus credenciales otra vez.
➡️ **Regresa a Configuración, luego a Integraciones y haz clic en "Habilitar" en la sección de HubSpot para continuar con los siguientes pasos.**
En el segundo paso, debes seleccionar la propiedad de HubSpot donde almacenas los números de teléfono de tus contactos.
¿Por qué es importante seleccionar la propiedad de teléfono?
Treble utiliza una de las dos propiedades de teléfono para identificar a tus contactos. Si no seleccionas la propiedad de teléfono, Treble no podrá identificar a tus contactos y no podrás enviar mensajes a través de Treble.
Si no tienes muy claro cuál es la propiedad que usas, puedes ir a HubSpot, luego a Configuración, Propiedades y escribir "phone" en el buscador. Allí podrás revisar cuál es la propiedad que más utilizas. Puedes ver el siguiente video para que te quede más claro.
El tercer paso solicita ingresar el identificador de tu empresa en HubSpot.
Para obtenerlo debes ingresar a HubSpot y copiar el número que encuentras en la parte superior izquierda.
Para terminar, en el cuarto paso debes ingresar el correo electrónico con el que accedes a HubSpot.
¡Felicitaciones! En este punto ya integraste tu compañía con Treble y HubSpot
# Plataforma de WhatsApp y Treble Dentro de HubSpot - Instalación de la Extensión de Chrome
**¿Qué es?:** La extensión de Treble para Chrome amplía las funcionalidades de Treble que se visualizan en la plataforma de HubSpot. Esta te permite ver la plataforma de WhatsApp dentro de HubSpot, lo que facilita que tus agentes respondan las conversaciones entrantes que reciban. Además, te permite realizar envíos masivos a través de workflows basados en las condiciones que elijas.
Una vez completada exitosamente la integración de HubSpot con tu compañía, el siguiente paso es descargar la extensión de Chrome. Esta extensión te permite ver la plataforma de WhatsApp dentro de HubSpot y también realizar envíos desde allí.
Tanto los administradores como los agentes deben instalar la extensión, por eso es importante que guardes estos datos para compartirlos cuando ellos necesiten descargarla. Cada agente debe descargar la extensión con el mismo código y enlace proporcionados.
En Treble, dirígete a Configuración → Integraciones → HubSpot
En este modal encontrarás información importante. Debes copiar el código y hacer clic donde dice "extensión de Chrome". El código es único para cada compañía y es el mismo para todas las personas que quieran descargar la extensión.
Al hacer clic en "conectar", espera unos segundos y verás el nombre de tu compañía en la extensión.
Justo después de conectar la extensión, dirígete a HubSpot, selecciona "Bandeja de entrada" y busca "WhatsApp" en la barra lateral izquierda.
¡FELICITACIONES! Ya terminaste la integración de HubSpot con tu compañía.
Recuerda que tus agentes solo necesitan descargar la extensión utilizando el mismo código y enlace proporcionados para poder ver WhatsApp dentro de HubSpot.
# Integración con HubSpot
Source: https://help.treble.ai/es/docs/integrations/hubspot/welcome
Esta guía te muestra cómo integrar Treble con HubSpot.
Treble te ayuda a aprovechar todo el potencial de WhatsApp para vender más, integrándose con HubSpot y utilizando IA para optimizar la comunicación. Permite automatizar interacciones con leads mediante chatbots inteligentes y mejorar aquellas que requieren acompañamiento humano con un sistema multi-agente potenciado por IA. Además, su integración con HubSpot facilita la sincronización de datos y contactos, registrando automáticamente las interacciones de WhatsApp y otros canales en la plataforma, lo que permite gestionar clientes, hacer seguimiento de oportunidades de ventas y mejorar la eficiencia del equipo de marketing y ventas sin perder el contexto de las conversaciones.
## Beneficios
La integración de **Treble**, con **HubSpot,** es beneficiosa porque permite una gestión más eficiente de la comunicación con clientes y leads. Algunas razones clave son:
1. **Centralización de Datos**: Todas las interacciones de WhatsApp se registran automáticamente en HubSpot, asegurando que la información de clientes y conversaciones esté unificada en un solo lugar.
2. **Automatización y Eficiencia**: Treble permite automatizar respuestas y flujos de trabajo mediante chatbots con IA. Toda esta información se guarda en el perfil del contacto dentro de actividades de contacto, lo cual permite tener todo el contexto del cliente dentro de HubSpot.
3. **Seguimiento y Personalización**: Con los datos de WhatsApp en HubSpot, los equipos de ventas y marketing pueden hacer un mejor seguimiento de oportunidades, segmentar clientes y ofrecer una experiencia personalizada basada en conversaciones previas.
Puedes hacer un mejor seguimiento y personalización basándose en las respuestas que tu cliente te dé, permitiéndote calificarlos y tenerlos en cuenta para futuros envíos.
4. **Colaboración Multiagente**: La combinación de Treble y HubSpot permite que varios agentes trabajen en la misma cuenta de WhatsApp sin perder contexto, lo que mejora la coordinación en la atención al cliente.
5. **Análisis y Reportes**: Se puede generar reportes y métricas sobre las interacciones de WhatsApp, brindando insights para optimizar estrategias de ventas y marketing.
En conclusión, la integración entre Treble y HubSpot optimiza la productividad y enriquece la experiencia del cliente mediante la combinación de comunicación ágil y gestión estructurada de relaciones.
# Integración con Salesforce
Source: https://help.treble.ai/es/docs/integrations/salesforce/welcome
Esta guía te muestra cómo integrar Treble con Salesforce.
Treble te ayuda a aprovechar todo el potencial de WhatsApp para vender más de forma integrada con Salesforce y con IA. Permite automatizar las interacciones con leads a través de chatbots con IA y optimizar las comunicaciones que requieren acompañamiento humano a través de un multi-agente potenciado con IA.
## Beneficios
1. Mejora el tiempo de primera respuesta y califica leads automáticamente
* Con una conversación automatizada de WhatsApp podrás realizar prospección en menor tiempo, nutrir a los leads menos calificados y enviar a tus agentes sólo los usuarios más interesados.
2. Obtén métricas y optimiza el performance de WhatsApp
* Entiende el desempeño de WhatsApp a través de reportes y métricas claras y optimiza tu uso del canal para aumentar tu ROI.
3. Escala tus operaciones de Marketing y Ventas con IA
* Usa Treble y dale superpoderes a tu equipo. Escala tus ventas en WhatsApp sin necesidad de contratar nuevos vendedores.
# Integraciones
Source: https://help.treble.ai/es/docs/integrations/welcome
Treble se integra con tus sistemas de información como HubSpot y Salesforce para automatizar y optimizar tus procesos de mensajería por WhatsApp. Descubre como puedes integrar Treble con tu CRM u otros sistemas de información.
## Siguientes Pasos
Configura tu CRM HubSpot en Treble.
Configura tu CRM Salesforce en Treble.
# Tutorial: Primera Conversación Transferida a un Agente
Source: https://help.treble.ai/es/docs/intro-to-treble/first-agent-convo
Aprende a crear una conversación inbound donde te escriban tus usuarios y transferirla a un agente de tu equipo en Treble.
## Tutorial: Primera Conversación Transferida a un Agente
En este tutorial, vamos a crear una conversación inbound donde te escriban tus usuarios y transferirla a un agente de tu equipo en Treble. Este tutorial es para que puedas entender cómo funciona la transferencia de conversaciones en Treble y asume que ésta es de las primeras veces que estás utilizando Treble.
### Ejemplos de Casos de Uso
* **Vendedor de productos para mascotas**: Un vendedor de productos para mascotas recibe mensajes de clientes potenciales a través de WhatsApp. El vendedor quiere responder a los mensajes de los clientes potenciales y transferir la conversación a un agente de su equipo en Treble.
* **Compañía de bienes raíces**: Tus clientes potenciales te escriben mensajes a tu número de WhatsApp preguntando por propiedades disponibles. Tienes un flujo que inicialmente califica a los clientes potenciales y luego los redirige a un asesor de tu equipo para que les pueda dar más información.
* **Agencia de viajes**: Tus asesores de viajes reciben mensajes de clientes potenciales a través de WhatsApp dado que tus clientes tienen tu número de WhatsApp desde un código QR.
#### Ejemplo de creación de una conversación inbound
Vamos a crear una conversación para recibir mensajes de clientes potenciales.
Supongamos que haces parte de una empresa que vende productos de joyería. Tienes un botón de WhatsApp en tu sitio web que los clientes potenciales pueden hacer clic para escribirte. Queremos recibir esos mensajes y responderles. ¿Cómo lo haríamos?
Primero, vamos a configurar nuestro equipo de agentes.
## Configurar el equipo de agentes
Lo primero que vamos a hacer es configurar nuestro equipo de agentes. Para esto, vamos a la sección de "Agentes" y vamos a crear un nuevo agente. Para hacerlo, ingresa con tus mismos credenciales de Treble a la plataforma de agentes. Puedes hacerlo desde el siguiente link: sales.treble.ai .
Después de que hayas ingresado, vamos a ir a la sección de "Agentes", aqui es donde vamos a crear un nuevo grupo (equipo) de agentes y una cuenta de agente.
Tu cuenta, como administrador dentro de sales.treble.ai, es un agente que puedes usar para responder a los mensajes de los clientes potenciales. Sin embargo, para este tutorial, recomendamos crear un agente nuevo y asignarlo a un nuevo equipo para que puedas entender mejor el flujo de la transferencia de conversaciones.
Has click ahora en el botón "Crear Nuevo Grupo". Vamos primero a crear un grupo de agentes para que después, cuando creemos el nuevo agente, lo agregues a este grupo. Al hacer click en el botón "Crear Nuevo Grupo", se te abrirá un campo de texto para que le des un nombre al grupo.
Vamos a darle el nombre de "Equipo Ventas".
Ahora vamos a crear una cuenta de agente. Para esto, haz click en el botón "Crear Cuenta de Agente".
Después de que hayas hecho click en el botón "Crear Cuenta de Agente", se te abrirá un modal para llenar los datos del nuevo agente.
En la parte de "Elige al menos un tag", vamos a seleccionar el equipo de ventas que creamos anteriormente: "Equipo Ventas".
Has click en el botón "Crear" y listo ✅.
Ahora, vamos a simular que somos el agente que acabamos de crear. Para esto, has logout de la cuenta de administrador y has click en el botón "Ingresar como Agente".
Para esto, has click en el ícono del perfil en la parte inferior izquierda de la pantalla y selecciona la opción "Cerrar sesión".
Ahora, ingresa con los nuevos credenciales que acabamos de crear a la cuenta de agente. Al ingresar, verás que ya no estás en la cuenta de administrador, sino que estás en la cuenta de agente. Los agentes son usuarios que solo pueden responder a los mensajes de los clientes potenciales. Toda las vistas de administración de agentes, como agregar agentes, ver reportes, etc. no estarán disponibles para los agentes.
Los agentes sólo pueden responder a los mensajes de los clientes potenciales cuando están activos. Para activar el agente, has click en el ícono del perfil en la parte inferior izquierda de la pantalla y selecciona la opción "Cambiar a activo".
¡Ya estás activo como agente! Ahora estamos listos para empezar a responder a los mensajes de los clientes potenciales.
La herramienta de agentes tiene esa y muchas otras funcionalidades que puedes explorar. Si quieres conocer más sobre la herramienta de agentes, has click en la caja inferior.
Conoce más sobre la herramienta de agentes.
## Configurar la conversación inbound
Vamos ahora a continuar creando la conversación inbound para recibir mensajes de los clientes potenciales.
Ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación".
Una vez que hayas ingresado al editor de conversaciones, puedes agregar cualquier bloque de mensajes. El primer bloque que agregues será por el cual va a empezar la conversación. Haz click en el botón y selecciona el tipo de bloque que deseas agregar. En este caso, vamos a agregar un bloque de **Mensaje con opciones** > **Botones interactivos**.
El mensaje que vamos a agregar es el siguiente:
> ¡Hola! Gracias por contactarnos a joyería BIJOU 💍. ¿Cómo te podemos ayudar hoy?
Adicionalmente, vamos a agregar dos botones interactivos. El primero será para la opción "Quiero comprar" y el segundo será para la opción "Ayuda con un pedido". Para agregar los botones interactivos, haz click en el botón **Agregar Botón** . Esto te permitirá agregar el texto del botón.
Puedes continuar agregando cualquier bloque de mensajes. En este caso, vamos a agregar un bloque de **Mensaje simple** para responderle al cliente en caso de que elija la opción "Ayuda con un pedido".
Vamos ahora a configurar el bloque de transferencia a agente. Para esto, haz click en el botón y selecciona el submenu **Transferencia a humano** y después selecciona la opción **Transferir a agente en Treble**. Conecta el bloque de transferencia a agente con la primera opción de "Quiero comprar".
Al agregar el bloque de transferencia a agente, seguramente habrás visto un bloque nuevo con el título: "DEFAULT". El título de este bloque es el nombre del equipo de agentes al que le transferirás la conversación. En este caso, debemos cambiarlo al equipo de agentes que creamos anteriormente: "Equipo Ventas".
Para esto, haz doble click en el bloque de transferencia a agente. Se te abrirá un panel a la izquierda de la pantalla. En este panel, puedes ver el nombre del equipo de agentes al que le transferirás la conversación. En el dropdown, selecciona el equipo de agentes que creamos anteriormente: "Equipo Ventas".
Si utilizas workflows de HubSpot para asignación o etiquetado de propiedades, puedes configurar un retraso antes de que Treble asigne la conversación a un agente. Esto garantiza que los workflows de HubSpot estén sincronizados con Treble antes de la asignación.
Para configurar el retraso:
1. Haz doble click en el bloque de transferencia a agente
2. En el menú de configuración, busca la opción "Retraso de asignación"
3. Activa la opción y configura los minutos de espera (recomendado: 2-5 minutos)
Ahora que hemos configurado la conversación, vamos a guardarla. Haz click en el botón "Crear Conversación" en la parte superior derecha de la pantalla. Dado que estamos creando una conversación inbound, vamos a seleccionar la opción "Recibir mensajes de clientes (inbound)". (Si tienes mas de una linea de WhatsApp, puedes seleccionar la linea que deseas recibir mensajes). Finalmente, has click en el botón "Continuar".
¡Ya tienes tu primera conversación inbound configurada! Ahora puedes probar la conversación enviando un mensaje a tu número de WhatsApp.
### Pruebas
Para probar la conversación, puedes enviar un mensaje a tu linea de WhatsApp configurada en Treble. Si todo está configurado correctamente, la conversación debería empezar y enviarte el mensaje de bienvenida. Una vez que hayas recibido el mensaje, puedes responderle a ese primer mensaje e ir por la opción "Quiero comprar".
Recibirás un mensaje en WhatsApp que tu conversación esta siendo transferida a un agente. Y ahora, si vuelves a la plataforma de agentes, verás que hay una nueva conversación en la sección de "Conversaciones".
Has click en la conversación y podrás ver el detalle de la conversación. Prueba respondiendo a tus mensajes.
¡Has logrado transferir una conversación a un agente! Con este proceso has aprendido como configurar una conversación inbound y transferirla a un agente.
# Conversación Inbound
Source: https://help.treble.ai/es/docs/intro-to-treble/inbound-convo
Conoce como crear una conversación inbound en Treble.
## Como crear una conversación inbound
Crear una conversación inbound es muy sencillo. Dado que las conversaciones inbound son iniciadas por los clientes, no es necesario crear una plantilla de mensaje. Si ya seguiste los pasos para crear una conversación outbound, el proceso es muy similar.
Ve a la sección de "Conversaciones" y haz click en el botón "Crear Conversación".
## Ejemplo de creación de una conversación inbound
Vamos a crear una conversación para recibir mensajes de clientes potenciales.
Supongamos que haces parte de una empresa que vende productos para mascotas. Tus clientes potenciales te envían mensajes a tu número de WhatsApp. Queremos recibir esos mensajes y responderles. ¿Cómo lo haríamos?
Una vez que hayas ingresado al editor de conversaciones, puedes agregar cualquier bloque de mensajes. El primer bloque que agregues será por el cual va a empezar la conversación. Haz click en el botón y selecciona el tipo de bloque que deseas agregar. En este caso, vamos a agregar un bloque de **Mensaje con opciones** > **Botones interactivos**.
Puedes continuar agregando cualquier bloque de mensajes. En este caso, vamos a agregar un bloque de **Mensaje simple** para responderle al cliente.
Conecta el primer bloque de mensaje con el segundo bloque de mensaje simple. Para hacerlo haz click en el círculo de salida del bloque de la plantilla y manten pulsado el click arrastrando el cursor hasta el círculo de entrada del bloque de mensaje simple.
Completa la conversación agregando los bloques restantes. Una vez hayas agregado los bloques pueden agregar el contenido de los bloques para tu conversación.
Una vez hayas completado la conversación, haz click en el botón **Crear Conversación** y luego en **Recibir mensajes de clientes (Inbound)**.
¡Has creado y configurado una conversación inbound!
## Editar una conversación inbound
En cualquier momento puedes editar una conversación inbound. Para hacerlo, puedes hacerlo desde la sección de "Conversaciones". Haz click en el botón "Editar" en la conversación que deseas editar.
Has las modificaciones necesarias y haz click en el botón "Publicar" para guardar los cambios.
## Próximos pasos
* ¿Quieres saber cómo conectar agentes a una conversación inbound? Consulta nuestra documentación sobre
.
## Dudas frecuentes
Mientras no hayas conectado tu propia linea, Treble te permitirá usar una cuenta de prueba. Sin embargo, para recibir mensajes de clientes potenciales, debes agregar los números de teléfono de los clientes potenciales a tu conversación. No te preocupes, una vez conectes tu propia linea, no será necesario agregar los números de teléfono.
Si ya habías configurado una conversación inbound y ahora quieres cambiarla, puedes hacerlo. Al crear y guardar una nueva conversación inbound, la conversación nueva conversación quedará configurada como la conversación inbound.
No, puedes configurar tantas conversaciones inbound como lineas de WhatsApp tengas configuradas. Si tu cuenta de Treble tiene múltiples lineas de WhatsApp, al momento de crear una conversación inbound, puedes seleccionar la linea de WhatsApp a la que quieres que se envíen los mensajes.
# Conversación Outbound
Source: https://help.treble.ai/es/docs/intro-to-treble/outbound-convo
Conoce como crear una conversación outbound en Treble.
## Como crear una conversación outbound
Crear una conversación outbound es muy sencillo. Para comenzar, ingresa a tu cuenta de Treble. Toda conversación outbound debe iniciar con una plantilla de mensaje (HSM). Meta necesita que las conversaciones outbound inicien con una plantilla de mensaje para asegurar que las conversaciones sean legítimas y cumplan con las políticas de WhatsApp. Por lo tanto, primero debes crear una plantilla de mensaje.
Para crear una plantilla de mensaje, puedes revisar la sección de
.
Asegúrate que hayas creado una plantilla de mensaje antes de continuar.
Después de que hayas creado una plantilla de mensaje, regresa a la sección principal de "Conversaciones" y haz click en el botón "Crear Conversación".
Las conversaciones en Treble son flujos donde agregar bloques de mensajes. Estos bloques y las conexiones entre ellos son los que definen la lógica de la conversación.
## Ejemplo de creación de una conversación outbound
Vamos a crear una conversación para un caso de uso de ventas.
Supongamos que haces parte de una empresa que vende productos para mascotas. Tienes una base de datos con números de teléfono de clientes potenciales que han dejado sus datos en tu sitio web. Queremos enviarles un mensaje contándoles sobre la promoción de la semana. ¿Cómo lo haríamos?
En la esquina superior izquierda de la pantalla encontrarás el botón . Haz click en él y selecciona "Mensaje Plantilla". Puedes buscar la plantilla que creaste anteriormente por su nombre.
Una vez que hayas agregado la plantilla de mensaje, puedes agregar bloques de mensajes. Haz click en el botón y selecciona el tipo de bloque que deseas agregar. En este caso, vamos a agregar un bloque de **Mensaje con opciones** > **Botones interactivos**.
Conecta el bloque de mensaje de la plantilla con el bloque de botones interactivos. Para hacerlo haz click en el círculo de salida del bloque de la plantilla y manten pulsado el click arrastrando el cursor hasta el círculo de entrada del bloque de botones interactivos.
Completa la conversación agregando los bloques restantes. Una vez hayas agregado los bloques pueden agregar el contenido de los bloques para tu conversación.
Para tus conversaciones outbound, te recomendamos que uses la funcionalidad de **Bloque Objetivo** para definir un objetivo medible de la conversación. Esto te permitirá medir el éxito de la conversación y optimizarla. Puedes leer más sobre el bloque objetivo en la sección de
Una vez hayas completado la conversación, haz click en el botón **Crear Conversación** y luego en **Enviar la conversación ahora (Outbound)**.
Una vez que hayas creado la conversación, puedes enviarla a tus clientes potenciales. Para poderla enviar a tu número de WhatsApp, debes agregar tu número de WhatsApp y agregar usuario. Dale click en el botón **Agregar Usuario** y en la siguiente vista **Enviar ahora mismo**.
Existen varios métodos para enviar la conversación. Puedes leer más sobre ellos en la sección de [Enviar Conversación](/es/docs/main-platform/send-convo).¡Has creado y enviado una conversación outbound!
# Empezar
Source: https://help.treble.ai/es/docs/intro-to-treble/welcome
Esta guía introduce las capacidades empresariales de Treble, la plataforma para desarrollar con Treble y cómo empezar a construir.
Empieza a usar Treble.ai en minutos. Sigue los siguientes pasos para empezar a usar Treble.
Configura tu primera conversación outbound en Treble.
Configura tu primera conversación inbound en Treble.
Crea tu primera plantilla (HSM) en Treble.
Conecta tu conversación con agentes en Treble.
# Conceptos Clave
Source: https://help.treble.ai/es/docs/key-concepts
Esta guía introduce conceptos clave de Treble como conversaciones, bloques, plantillas y más.
## Conversaciones
Las conversaciones, también conocidas como campañas, son flujos de mensajes que te permiten interactuar con tus contactos/clientes. Cuando abras la plataforma de Treble, verás una lista de conversaciones que has creado.
### Conversación Outbound
Las conversaciones outbound, tambien conocidas como conversaciones iniciadas por la compañía, son aquellas que se envían a un grupo de contactos/clientes. Estas conversaciones en Treble deben empezar con una plantilla (HSM) y luego puedes agregar bloques de mensajes para continuar la conversación. Para conocer más sobre las plantillas, puedes leer la sección de
. Algunos ejemplos de este tipo de conversaciones son:
* Tienes una base de datos con números de teléfono de clientes potenciales que han dejado sus datos en tu sitio web. Queremos enviarles un mensaje contándoles sobre la promoción de la semana.
* Manejas un negocio de reparación de computadoras y deseas enviarles un mensaje a tu cliente confirmando que su computadora ya está lista para ser recogida.
* Mantienes la información de tus clientes en un CRM y deseas contactar a tus prospectos para calificarlos por WhatsApp.
### Conversación Inbound
Las conversaciones inbound, tambien conocidas como conversaciones iniciadas por el cliente, son aquellas que se reciben de un contacto/cliente. Este tipo de conversaciones son ideales cuando deseas que tus contactos/clientes inicien una conversación contigo. Algunos ejemplos de este tipo de conversaciones son:
* Un cliente que ve tu número de teléfono en tu sitio web y te envía un mensaje para que le ayudes.
* Un cliente que escanea un código QR y te envía un mensaje para contactarte por una promoción.
* Un cliente que te hace click en una publicidad en Instagram y te escribe para conocer más sobre tu producto.
## Plantillas (HSM)
Las plantillas, tambien conocidas como HSM (Highly Structured Message), son mensajes predefinidos que son usados en conversaciones de WhatsApp Business API, principalmente se usan en las conversaciones outbound. Para conocer más sobre las plantillas, puedes leer la sección de
.
## Agentes
En Treble puedes configurar que tus conversaciones sean enviadas a un agente. Los agentes son usuarios de Treble que usan la plataforma de agentes para enviar y recibir mensajes de las conversaciones que hayas configurado que puedan ser transferidas a un agente. Para conocer más sobre los agentes, puedes leer la sección de
.
## WABA (WhatsApp Business Account)
La WABA, tambien conocida como "WhatsApp Business Account" (Cuenta de Negocios de WhatsApp), es la cuenta comercial que le permite a las empresas interactuar con sus clientes a través de la plataforma de mensajería de WhatsApp de manera más profesional y con funcionalidades adicionales.
Características principales de una WABA:
1. Verificación: Las cuentas WABA son verificadas, lo que ayuda a generar confianza entre los usuarios.
2. Perfil empresarial: Permite mostrar información importante de la empresa como dirección, horarios, sitio web, etc.
3. Acceso a la API de WhatsApp Business: Esto posibilita la automatización de mensajes y la integración con otros sistemas de la empresa.
4. Mensajes interactivos: Capacidad de enviar mensajes con elementos interactivos como botones o enlaces clicables.
5. Gestión avanzada de conversaciones: Facilita el manejo de múltiples conversaciones y clientes de forma más eficiente.
## Próximos pasos
Configura tu primera conversación inbound y outbound en Treble.
Configura tus agentes en Treble.
# Herramienta de llamada a API
Source: https://help.treble.ai/es/docs/main-platform/ai-center/agents/ai-agent/api-tool
Cómo configurar y usar la herramienta de llamado a API
La herramienta de llamada a API permite que el agente haga llamados API a servicios externos durante la ejecución. Úsala cuando necesites enviar información o realizar acciones en tu sistema.
* **Configura la URL** completa con protocolo https.
* **Define el cuerpo** que el agente debe enviar en caso de ser necesario. El cuerpo debe incluir toda la información relevante para que el servicio responda sin pasos adicionales.
* **Limita el tiempo de respuesta**: el servicio debe contestar en menos de 10 segundos o la llamada se considerará fallida.
* **Salidas sin procesamiento**: el agente no transforma la respuesta del servicio externo. El endpoint debe devolver una respuesta de tipo JSON.
## Uso de variables en la llamada a API
La herramienta de llamada a API te permite utilizar variables dentro del contexto del agente en los **encabezados**, los **parámetros de URL** o el **cuerpo** del request. Esto es útil para personalizar cada llamada con datos relevantes del usuario o de la conversación.
### Cómo referenciar variables
Las variables se insertan usando doble llave, por ejemplo: `{{nombre_variable}}`.
### Buenas prácticas
* **Verifica que las variables existan antes de usarlas:** Asegúrate de que el agente haya recolectado la información necesaria antes de enviar la llamada.
* **Usa nombres descriptivos:** Mantén un estándar en los nombres de variables para evitar confusiones o errores de reemplazo.
Antes de habilitar la herramienta en producción, prueba el flujo con datos reales para confirmar tiempos, formatos y manejo de errores.
# Integración con Google Calendar
Source: https://help.treble.ai/es/docs/main-platform/ai-center/agents/ai-agent/google-calendar
Conecta Google Calendar al Automatizador de Tareas IA y permite que el agente agende, reprograme o cancele citas automáticamente.
Esta funcionalidad está en **beta**. Por favor consulta a tu CSM para habilitarla en tu cuenta antes de seguir estos pasos.
## Cómo conectar tu cuenta de Google Calendar a Treble
1. Ve a la página de **Configuración**.
2. Haz clic en **Integraciones** y luego abre la pestaña secundaria **Apps Conectadas**.
3. Haz clic en el botón **Conectar App**.
4. Selecciona **Google Calendar** de la lista de opciones disponibles.
Asegúrate de seleccionar **Google Calendar** y no **Google**.
a. Verás la pantalla de Google OAuth. Si tienes varias cuentas, selecciona la que tiene el calendario que quieres conectar.
b. Es importante que selecciones la cuenta que es **dueña del calendario** que quieres usar.
c. Es posible que veas un aviso sobre `unified.to` — esto es esperado. Treble utiliza Unified como puente para gestionar esta integración. Haz clic en **Continuar**.
d. Verás una pantalla detallada que explica que Treble podrá acceder a tus calendarios, invitados y eventos, y crearlos o modificarlos. Esto es necesario para que la IA pueda agendar citas. Haz clic en **Permitir**.
e. Google Calendar ahora aparecerá en tu lista de **Apps Conectadas**.
## Cómo usar Google Calendar con el Automatizador de Tareas IA
Una vez que conectaste tu cuenta de Google Calendar, ve a **Agentes de IA**.
1. Haz clic en **Crear Agente IA**.
2. Selecciona **Automatiza tareas complejas** y dale un nombre al agente.
3. Ten en cuenta que la IA **no tiene contexto previo** sobre tu negocio, horarios ni ninguna otra información. Piénsalo como un empleado nuevo — tienes que contarle todo lo relevante.
4. Al final de la lista de **Herramientas**, encontrarás **Apps Conectadas**.
5. Haz clic para abrir el modal y selecciona **Google Calendar** de tus apps instaladas.
6. Elige entre las herramientas disponibles del calendario:
* **List Calendar Events** — Obtiene los eventos existentes para verificar disponibilidad.
* **Create Calendar Event** — Agenda una nueva cita.
* **Update Calendar Event** — Reprograma o modifica un evento existente.
7. ¡Listo! Usa las herramientas en las instrucciones de tu agente y consulta el ejemplo a continuación para entender cómo configurarlas.
## Ejemplo de prompt
Las instrucciones deben ser detalladas ya que la IA tomará sus propias decisiones cuando no estén claras. A continuación hay un ejemplo usado para agendar citas en una clínica dental.
```
Tu responsabilidad es agendar, reprogramar o cancelar citas mientras sigues estrictamente las reglas de disponibilidad. En el primer mensaje saluda al usuario, si en algún momento te dice su nombre recuerda el nombre para usarlo al momento de agendar.
Primer mensaje (puedes variarlo ligeramente):
Gracias por escribir a Dentistas ROCKET, ¿cómo podemos ayudarte? Ofrecemos limpiezas dentales y extracciones de muelas con profesionales de la salud.
---
Contexto básico:
Somos una clínica dental que ofrece los siguientes servicios:
- Limpieza dental
- Extracción de muelas
- Fotografía y rayos x
- Resinas
Si el usuario pregunta por algún precio en específico usa esta tabla de precios:
- Limpieza dental $500.00 MXN
- Extracción muelas $1,500.00 MXN por muela
- Fotografías $300.00
- Rayos X $350.00
- Resinas $1,100.00 por resina
- Mantenedor de Espacio Fijos $2,350.00
- Mantenedor de Espacio Removibles $2,350.00
- Guarda Oclusal $2,600.00
- Obturación de Resina $600.00
- Obturación de Ceromero $600.00
- Carilla de Ceromero Directa $6,000.00
- Blanqueamiento Convencional $4,500.00
- Blanqueamiento con Láser $5,200.00
Si el servicio que busca no está en la lista, no des ningún precio, menciona que el precio y tratamiento depende de cada caso en particular y se recomienda una revisión y consulta.
1. Horario de atención
- La clínica opera de lunes a viernes.
- Horario laboral: 09:00 – 17:00 (zona horaria local CDMX)
- No se permiten citas fuera de este horario, la última cita se agenda 4:30.
- No se permiten citas los fines de semana.
2. Duración de las citas
- Cada cita dura 30 minutos.
- Las citas deben comenzar únicamente en intervalos válidos de 30 minutos:
09:00, 09:30, 10:00, 10:30, 11:00, 11:30, 12:00, 12:30, 13:00, 13:30, 14:00, 14:30, 15:00, 15:30, 16:00, 16:30
4. Manejo de zona horaria
Toda la programación se basa en la zona horaria local de la clínica.
Convierte las horas del usuario a la zona horaria local antes de verificar disponibilidad.
Siempre confirma las horas de la cita en zona horaria local al responder.
5. Comportamiento al agendar
---
Skill para obtener eventos de calendario:
Connected App: Google Calendar
Tool: List Calendar Events
---
Para agendar una cita:
- Pide el correo electrónico de la persona, es para que pueda recibir una invitación en su calendario
- No inventes el correo de la persona, si no te lo quiere dar explica que es necesario, el sistema de citas requiere un correo
- Verifica el horario para agendar, usa el horario y la fecha que el cliente desea a menos que haya un conflicto
- El titulo del evento es "[🤖CITA] - {nombre del cliente}"
- Recuerda usar UTF-8 para maximizar compatibilidad con emojis y tildes
- Recuerda que los horarios los da el cliente en horario local, debes convertir el horario a UTC antes de guardarlo en el API
- Revisar el calendario para eventos existentes.
- Asegurarte de que el horario solicitado:
- Está dentro del horario laboral
- No está ya reservado.
- Encaja completamente dentro de un bloque de 30 minutos.
- No genera citas superpuestas.
Si un horario no está disponible: Ofrece las alternativas disponibles más cercanas.
Connected App: Google Calendar
Tool: Create Calendar Event
---
Para reagendar:
- Siempre verifica que la cita exista usando el horario y correo proporcionado
- Busca el evento original y modifícalo, no lo canceles
- Puedes buscar todos los eventos si sabes un rango de fechas en el cual buscar
- Si ya hay un evento en el calendario menciona al cliente que ya está ocupado el espacio pero ofrece uno más temprano o uno más tarde si hay disponibilidad
- Recuerda usar UTF-8 para maximizar compatibilidad con emojis y tildes
- Recuerda que los horarios los da el cliente en horario local, debes convertir el horario a UTC antes de guardarlo en el API
Connected App: Google Calendar
Tool: Update Calendar Event
---
- Recuerda que no puedes enviar correos electrónicos ni SMS al usuario, el sistema se encarga únicamente de agendar las citas internamente
- Siempre convierte los horarios del cliente desde su zona horaria local a UTC antes de guardarlos en el API. Confirma la hora de la cita al usuario en su zona horaria local.
```
## Herramientas disponibles de Google Calendar
| Herramienta | Descripción |
| ------------------------- | ------------------------------------------------------------------------------------------ |
| **List Calendar Events** | Obtiene los eventos en un rango de fechas para verificar disponibilidad antes de agendar. |
| **Create Calendar Event** | Crea un nuevo evento en el calendario con título, horario, duración y correo del invitado. |
| **Update Calendar Event** | Modifica un evento existente — usa esta herramienta para reprogramar sin cancelar. |
## Configuración de parámetros
Algunas herramientas te pedirán editar parámetros. Si no estás seguro de qué cambiar, deja que la IA los maneje todos — solo es útil si necesitas enviarle un valor fijo, como una descripción predeterminada, una zona horaria fija u otro valor específico. Esto sobreescribirá el valor que la IA intente generar, por lo que se recomienda dejar que la IA lo gestione a menos que sepas exactamente qué valor necesitas. Siempre puedes cambiarlo después si ves algún problema o cambias de opinión.
# Introducción
Source: https://help.treble.ai/es/docs/main-platform/ai-center/agents/ai-agent/overview
Agente IA capaz de mantener una conversación natural y tomar acciones autónomas usando herramientas.
El **Agente de IA** te permite diseñar flujos conversacionales que manejan procesos con múltiples posibilidades. Sus principales fortalezas son la capacidad de integrar **herramientas** adaptadas a las necesidades de tu negocio y la flexibilidad de definir su comportamiento directamente en las instrucciones, sin añadir complejidad innecesaria.
No necesitas escribir esas instrucciones a mano: cuando [creas un agente](/es/docs/main-platform/ai-center/create-agent), Treble las redacta a partir de lo que le describes. Esta página explica qué contienen, cómo ajustarlas y qué puede hacer el agente.
## ¿Es para ti?
* Tienes un proceso complejo que quieres que la IA gestione.
* Existen múltiples posibilidades dentro de una misma conversación.
* Necesitas definir diferentes reglas de salida o de escalamiento.
* Buscas avanzar en un proceso de ventas.
* Quieres reducir el tiempo de respuesta a prospectos.
* Solo necesitas enviar un mensaje fijo o una plantilla, sin conversación de por medio.
* El flujo se resuelve con bloques de pregunta y respuesta y condicionales simples.
## Casos de uso
* Calificación avanzada de leads con múltiples rutas de salida.
* Envío automatizado de información postventa.
* Comunicación con asistentes después del registro a un webinar.
* Asistencia para ayudar al usuario a elegir un producto entre varias opciones.
* Seguimiento automático de carritos abandonados.
## Cómo leer las instrucciones generadas
Las instrucciones que escribe Treble siguen una estructura consistente. Conocerla te ayuda a ubicar rápido qué modificar cuando el agente no se comporta como esperas:
| Sección | Qué contiene | Cuándo tocarla |
| --------------------------- | ------------------------------------------------------- | ---------------------------------------------------- |
| **Identidad y voz** | Quién es el agente, tono y estilo. | El agente suena demasiado formal, frío o largo. |
| **Meta, alcance y límites** | Qué debe lograr y de qué no puede hablar. | El agente responde temas fuera de tu negocio. |
| **Pasos y reglas** | El orden de la conversación y sus criterios. | Pide datos en mal orden o no cierra cuando debería. |
| **Herramientas** | Cuándo llamar cada herramienta y qué validar antes. | Una herramienta no se usa, o se usa a destiempo. |
| **Casos límite** | Qué hacer si falta información o el contacto se desvía. | Aparece una situación que el agente no supo manejar. |
| **Salidas y escalamiento** | Cuándo terminar, cuándo derivar y qué registrar. | Las conversaciones no llegan al equipo correcto. |
Ajusta una sección a la vez y prueba en el playground después de cada cambio. Reescribir todo el prompt de una vez hace muy difícil saber qué fue lo que mejoró o empeoró el comportamiento.
### Escribir las instrucciones desde cero
Si prefieres partir de una página en blanco, o quieres entender qué está haciendo el generador, esta es la estructura recomendada:
1. **Contexto y objetivo**
* Explica qué debe lograr el agente y en qué escenario se usa.
2. **Tono y estilo**
* Indica el registro deseado (por ejemplo, profesional y claro).
3. **Conocimiento disponible**
* Indica cuándo consultar la base de conocimientos y cuándo no hacerlo.
4. **Herramientas disponibles**
* Nombre, propósito, parámetros, precondiciones y límites de cada herramienta.
* Reglas de uso: cuándo llamarla, qué validar antes y qué devolver después.
5. **Descripción de la tarea con reglas explícitas**
* Pasos a seguir, prioridades, criterios de finalización y de éxito.
* Qué hacer si falta información y cómo pedirla.
6. **Capacidades y no-capacidades**
* Lo que el agente puede hacer y lo que no puede hacer (ni debe prometer).
7. **Ejemplos concretos**
* Muestras de entradas y salidas correctas, más uno o dos contraejemplos.
8. **Razonamiento**
* Recordatorio para pensar paso a paso antes de responder.
9. **Escalamiento y salidas**
* Cuándo finalizar, cuándo escalar y qué datos registrar.
Empieza con un alcance acotado, suma herramientas de forma incremental y expande la cobertura a medida que los resultados sean consistentes.
💡Una vez que tu agente responda correctamente en el playground, dirígete al **Creador de Conversaciones** y agrega el bloque **Agente AI** a tu flujo. Lo encuentras en la sección de bloques avanzados.
## Herramientas
El Agente de IA puede usar diferentes herramientas para ejecutar acciones dentro o fuera de la conversación. Estas herramientas amplían sus capacidades, permitiéndole consultar información, crear tickets o actualizar propiedades en sistemas externos como HubSpot, además de interactuar con funciones nativas de Treble.
Cuando generas un agente, Treble elige las herramientas que necesita y las inserta en las instrucciones. Las que requieren datos tuyos quedan marcadas como pendientes de configuración; puedes completarlas y agregar otras desde el [editor](/es/docs/main-platform/ai-center/configure-agent).
### Generales
* **Buscar en la Web** — Busca información actualizada o contextual en internet.
* **Enviar documento** — Envía un archivo al usuario durante la conversación.
* **Enviar imagen** — Envía una imagen al usuario durante la conversación.
### Treble
* **Leer variable** — Referencia el valor de una variable dentro de las instrucciones.
* **Guardar respuesta como variable** — Guarda la respuesta del contacto en una variable de Treble.
* **Transferir a un agente** — Escala la conversación a un agente humano en Treble.
* **Enviar conversación** — Envía el contacto a otro flujo de Treble.
* **Cerrar conversación** — Finaliza la interacción después del tiempo que definas.
### HubSpot
* **Transferir a un agente** — Envía la conversación a otro agente o equipo dentro de HubSpot.
* **Crear ticket** — Genera un nuevo ticket con la información recopilada.
* **Leer Propiedad de Contacto** — Consulta el valor de una propiedad específica de un contacto.
* **Guardar / Editar propiedad** — Actualiza una propiedad de contacto con datos de la conversación.
### Avanzadas
* **Llamada a API** — Realiza un llamado a una API externa con valores fijos o con variables que el agente haya recolectado. Ver la [guía de la herramienta API](/es/docs/main-platform/ai-center/agents/ai-agent/api-tool).
* **Apps Conectadas** — Ejecuta acciones en las aplicaciones que conectaste a Treble, como [Google Calendar](/es/docs/main-platform/ai-center/agents/ai-agent/google-calendar) o [Shopify](/es/docs/main-platform/ai-center/agents/ai-agent/shopify-usage).
Las herramientas de HubSpot solo aparecen si tienes la integración conectada, y **Apps Conectadas** muestra únicamente las aplicaciones que ya vinculaste a tu cuenta.
## Preguntas frecuentes
Es un agente de IA diseñado para manejar flujos conversacionales con múltiples posibilidades, integrando herramientas y lógica avanzada para ejecutar tareas automáticas.
No. Describes lo que necesitas, respondes algunas preguntas y Treble redacta las instrucciones, elige las herramientas y arma la base de conocimientos. Tu trabajo es revisar el resultado, completar las herramientas pendientes y probarlo.
No. Toda la configuración se hace desde la interfaz de Treble.
Sí. El agente puede **entender mensajes de voz enviados por los usuarios a través de WhatsApp** y responderá automáticamente con texto en la conversación.
Revisa las instrucciones e intenta hacerlas más explícitas. Ubica la sección correspondiente en la tabla de arriba y agrega el caso que falló como ejemplo concreto.
Sí. El agente puede integrarse dentro de un flujo más amplio, y puede activar o cerrar conversaciones, guardar respuestas o llamar herramientas externas según tus reglas.
Herramientas **generales**, **de Treble**, **de HubSpot** y **avanzadas**, incluyendo acciones como crear tickets, leer o editar propiedades, enviar documentos, transferir conversaciones, llamar a una API o buscar información en la web.
Usa el [playground](/es/docs/main-platform/ai-center/playground) para ejecutar pruebas controladas con diferentes inputs, y envíate una conversación de prueba por WhatsApp. Itera hasta que el agente responda correctamente en todos los casos.
Sí. El agente puede entender imágenes enviadas por WhatsApp y usar lo que ve para guiar sus acciones. Por ejemplo, puede reconocer objetos, leer texto en capturas de pantalla o interpretar elementos en la imagen para decidir qué hacer.
Sin embargo, el agente no genera ni crea imágenes. Su capacidad visual se centra en interpretar y actuar sobre imágenes existentes, no en producir nuevas.
Define reglas claras de salida o escalamiento. Si el agente no puede resolver una situación, transfiere la conversación a un agente humano o registra el evento en un ticket.
No aprende automáticamente de cada interacción, pero puedes **mejorar su comportamiento** iterando sobre las instrucciones y ajustando las herramientas o condiciones de salida.
## Consideraciones importantes
**Privacidad:** Informa a usuarios que sus datos serán guardados y cumple con regulaciones aplicables (GDPR, etc.).
# Configurar la integración con Shopify
Source: https://help.treble.ai/es/docs/main-platform/ai-center/agents/ai-agent/shopify-install
Sigue estos pasos para configurar la integración con Shopify en Treble.
Esta funcionalidad está en **beta**. Por favor consulta a tu CSM para
habilitarla en tu cuenta antes de seguir estos pasos.
## Requisitos previos
* Debes tener una cuenta de Shopify
* Debes haber iniciado sesión como administrador de la cuenta de Shopify
* Debes tener una tienda Shopify
Esta guía se divide en tres partes:
1. Crear una aplicación personalizada de Shopify que permita a Treble acceder a tus datos de Shopify
2. Instalar la aplicación personalizada de Shopify en tu tienda Shopify
3. Vincular la aplicación personalizada de Shopify a Treble
## 1. Crear una aplicación personalizada de Shopify
1. Entra al administrador de Shopify [https://admin.shopify.com/](https://admin.shopify.com/) y, en la parte inferior izquierda de la pantalla, haz clic en "Settings"
2. En la página de configuración, haz clic en "Apps"
3. Verás esta pantalla si no tienes aplicaciones creadas o instaladas; si ya tienes algunas, también aparecerán aquí. Nos interesa el botón "Develop apps" en la parte superior derecha
4. Por cómo funciona Shopify, necesitarás crear una aplicación personalizada: haz clic en el botón "Create an app" *(Nota: No es lo mismo que crear aplicaciones en el Shopify Dev Dashboard)*
5. En el campo App name, escribe "Treble" y elige cualquier correo disponible de tu organización en el menú desplegable
6. Haz clic en el botón "Create app"
### Una vez creada la aplicación, configura las credenciales
1. Haz clic en la pestaña "API credentials"
2. Haz clic en "Configure Admin API scopes"; verás una lista de casillas. Deben estar marcadas las siguientes:
* `read_customers`
* `write_inventory`
* `read_inventory`
* `read_locations`
* `write_orders`
* `read_orders`
* `write_products`
* `read_products`
3. Haz clic en "Save"
4. La aplicación personalizada se ha creado 🎉
## 2. Instalar la aplicación personalizada de Shopify en tu tienda
Después de crear la aplicación, debes instalarla en tu tienda Shopify.
Deberías ver un botón "Install app" en la pestaña API credentials
1. Haz clic en el botón "Install app"
2. En el modal de confirmación, haz clic en el botón "Install"
Confirmas que la aplicación que creamos tendrá acceso a tus datos de Shopify; es necesario para continuar
3. Luego verás esta pantalla con un token. Es **muy importante guardarlo en un lugar seguro, como un gestor de contraseñas**; **Shopify solo te lo mostrará una vez**. Si lo pierdes, tendrás que repetir el proceso desde la sección 1
4. **Haz clic en "Reveal token once" y guárdalo**; lo usarás en la sección 3
## 3. Vincular la aplicación personalizada de Shopify a Treble
Para este paso necesitas:
* El token de la aplicación Shopify de la sección 2
* El ID de tu tienda Shopify
Para conocer tu ID de tienda Shopify, mira la URL de tu tienda; debería ser algo como [https://yourstore.myshopify.com](https://yourstore.myshopify.com); la parte "yourstore" es tu ID de tienda
En nuestro ejemplo, el ID de tienda es `treble-ixclr4yg`
1. Inicia sesión en Treble [https://app.treble.ai/](https://app.treble.ai/)
2. Ve a la página "Settings"
3. Haz clic en la pestaña **"Integrations"** o en [esta URL](https://app.treble.ai/en/dashboard/settings/integrations/native-integrations)
4. Haz clic en la subpestaña "Connected Apps"
5. Busca el botón "Connect App" y selecciona "Shopify" en la lista de opciones disponibles
6. Verás un formulario donde debes introducir lo siguiente:
* Admin API access token: es el token que obtuviste en la sección 2
* Store ID: es el ID de tienda; en este ejemplo es `treble-ixclr4yg`, pero debes usar el tuyo
* Cuando ambos valores estén completos, haz clic en "Authorize"
7. Si todo va bien, verás el mensaje "App connected successfully" y la aplicación Shopify en la lista de aplicaciones conectadas
# Cómo usar Shopify en tus conversaciones
Source: https://help.treble.ai/es/docs/main-platform/ai-center/agents/ai-agent/shopify-usage
Sigue estos pasos para usar Shopify en tus conversaciones.
Esta funcionalidad está en **beta**. Por favor consulta a tu CSM para habilitarla en tu cuenta antes de seguir estos pasos.
## Requisitos previos
* Debes conectar tu cuenta de Shopify a Treble siguiendo los pasos de la guía [Configurar la integración con Shopify](/es/docs/main-platform/ai-center/agents/ai-agent/shopify-install)
## Cómo usar Shopify en tus conversaciones
1. Ve a la página "Agentes de IA" o a [esta URL](https://app.treble.ai/en/dashboard/ai-center)
2. Haz clic en el botón "Create AI Agent"
3. Busca la opción "Automate complex tasks" y haz clic en ella
4. Pon un nombre al agente y haz clic en el botón "Create"
5. En esta pantalla podrás escribir las instrucciones para tu agente de IA
6. Busca la sección "Advanced" y haz clic en el botón "Connected Apps" en la parte inferior de la pantalla
7. Busca la aplicación "Shopify" en la lista de aplicaciones instaladas y haz clic en ella
#### Las herramientas disponibles son:
* List Accounting Invoices
* Get Accounting Invoice
* Create Accounting Invoice
* Update Accounting Invoice
* List Accounting Contacts
* Get Accounting Contact
* Get Accounting Salesorder
* Create Accounting Salesorder
* List Accounting Salesorders
Selecciona cualquiera de las herramientas y, al hacer clic, verás que el tercer desplegable "Parameters" cambia.
El desplegable "Parameters" mostrará los parámetros de la herramienta; debes completarlos antes de que la herramienta pueda usarse.
*Algunas herramientas te pedirán editar parámetros. Si no estás seguro de qué cambiar, deja que la IA gestione todos.*
Cambiar parámetros solo es útil si necesitas enviar manualmente un valor fijo a la IA, como una descripción fija, una zona horaria, una moneda u otro valor concreto.
Esto sobrescribirá el valor que la IA intenta generar, así que se recomienda dejar que la IA lo gestione salvo que conozcas el valor exacto que buscas. Siempre puedes actualizarlo si ves algún problema o cambias de opinión.
Si dejas que la IA gestione todos los parámetros, puedes omitir el paso 3; de lo contrario, introduce en el paso 3 los valores fijos que quieras usar.
Al hacer clic en "Save" verás la acción configurada en el editor de tu agente de IA; ya puedes usarla en tus conversaciones.
## Herramientas de Shopify disponibles
Como referencia, estas son las herramientas de Shopify que puedes usar en el agente Automate complex tasks:
| Acción | Descripción | Útil para |
| ---------------------------- | ------------------------------------------------------ | ------------------------------------------------------------------------------------------------- |
| List Accounting Invoices | Obtiene una lista de facturas del sistema contable | Mostrar historial de facturas, sincronizar datos, paneles, filtrar por estado (pagado, pendiente) |
| Get Accounting Invoice | Recupera una factura por su ID | Mostrar el detalle completo, validar estado de pago, adjuntar a interacciones |
| Create Accounting Invoice | Crea una factura nueva en el sistema contable | Generar facturas tras la compra, automatizar facturación, sincronizar pedidos con contabilidad |
| Update Accounting Invoice | Modifica una factura existente | Marcar como pagada, actualizar líneas, corregir importes, sincronizar cambios de estado |
| List Accounting Contacts | Devuelve una lista de contactos (clientes/proveedores) | Sincronizar bases de datos de clientes, emparejar usuarios con registros contables |
| Get Accounting Contact | Obtiene un contacto por su ID | Recuperar datos de facturación, validar información del cliente, vincular con facturas/pedidos |
| Get Accounting Salesorder | Recupera un pedido de venta concreto | Consultar detalles del pedido, validar el estado de cumplimiento |
| Create Accounting Salesorder | Crea un nuevo pedido de venta | Enviar pedidos a contabilidad antes de facturar, flujos B2B |
| List Accounting Salesorders | Obtiene una lista de pedidos de venta | Informes, sincronizar pipelines de pedidos, conciliar pedidos y facturas |
# Califica clientes potenciales
Source: https://help.treble.ai/es/docs/main-platform/ai-center/agents/lead-qualification
Automatiza la calificación de leads las 24 horas con IA que recopila datos y los guarda directamente en tu CRM
**Este agente está en proceso de retiro.** En el creador de conversaciones el bloque aparece marcado como *Caduca pronto*. Los agentes que ya tienes creados siguen funcionando con normalidad, pero para agentes nuevos usa el [Agente de IA](/es/docs/main-platform/ai-center/agents/ai-agent/overview), que cubre este caso de uso y además puede ejecutar acciones con herramientas.
El agente **Califica clientes potenciales** recopila información de prospectos mediante conversaciones naturales y guarda los datos en HubSpot, Sheets o variables de Treble para que luego puedas usar bloques condicionales para redirigir a tus usuarios por caminos personalizados.
## ¿Es para ti?
* Recopilar información de contacto automáticamente
* Capturar datos sin errores manuales
* Actualizar tu CRM automáticamente
* Preparar información para tu equipo de ventas
* Reducir tiempo de respuesta a prospectos
* Solo necesitas responder preguntas (usa [Logra un objetivo concreto](/es/docs/main-platform/ai-center/agents/objective-ai))
* Requieres decisiones complejas automáticas
## Casos de uso por industria
**Recopila:** Presupuesto, zona de interés, tipo de propiedad, urgencia
**Resultado:** Agentes enfocan tiempo en prospectos con presupuesto real
**Recopila:** Tipo de consulta, urgencia, disponibilidad, seguro médico
**Resultado:** Consultas mejor preparadas con información previa del paciente
**Recopila:** Nivel educativo, programa de interés, modalidad, disponibilidad
**Resultado:** Asesores priorizan prospectos según criterios académicos
**Recopila:** Alcance del proyecto, presupuesto, experiencias previas, timeline
**Resultado:** Propuestas más precisas desde el primer contacto
**Recopila:** Categoría de producto, rango de presupuesto, volumen de compra, urgencia
**Resultado:** Recomendaciones personalizadas y ofertas específicas por perfil
***
## Configuración básica
**Estilo de Comunicación:** Ajusta el control deslizante según tu marca:
* **Casual**: Conversación relajada y amigable
* **Profesional**: Tono formal y empresarial
Esta configuración determina cómo el agente se comunicará con tus prospectos.
En el área de texto **"Definir Rol del Agente"**, describe específicamente:
* Qué hace tu empresa
* Cuál es el objetivo del agente
* Cómo debe comportarse
**Usa el botón "Generar un ejemplo"** para obtener una plantilla base que puedes personalizar.
```
Ejemplo:
Eres un asistente de [Tu Empresa] que recopila información
de prospectos interesados en [servicios/productos].
Tu objetivo es entender sus necesidades para que nuestro
equipo pueda ofrecerles la mejor solución.
```
Las reglas de interacción son todas las preguntas que este agente hará a tus clientes. En la configuración también podrás elegir el destino de los datos:
* **HubSpot**: Los datos se guardan directamente en tu CRM
* **Google Sheets**: Información se almacena en una hoja de cálculo
* **Variable Treble**: Variables internas para usar con otros bloques
**Usa "Generar un ejemplo"** para obtener un formato optimizado de preguntas.
En esta etapa podrás ver todas las opciones de salida que tiene el agente. Estas opciones te permitirán conectar con otros bloques en el creador de conversaciones:
* **Todas las acciones se completaron**: Cuando recopile toda la información solicitada
* **Quedaron acciones sin completar**: Con información parcial
* **No se completó ninguna de las acciones**: Si el usuario no proporciona ninguna información relevante
* **Conversación crítica**: Para casos que requieren intervención humana inmediata, por ejemplo cuando el usuario está molesto
**Sube tu base de conocimientos** para que el agente pueda responder preguntas sobre:
* Descripción de tu empresa
* Productos o servicios
* Precios generales
* Preguntas frecuentes
**Formatos soportados:** PDF, DOCX, TXT, direcciones web de tu sitio.
**Haz clic en "Guardar"** para crear el agente. Una vez guardado, estará disponible para usar en el Creador de Conversaciones.
1. **Ve al Creador de Conversaciones**
2. **Arrastra el bloque "Calificación de Leads con IA"** a tu flujo
3. **Selecciona tu agente** de la lista desplegable
4. **Configura los seguimientos automáticos** para usuarios que no responden:
* **Frecuencia**: Cada X minutos (recomendado: 30-90 minutos)
* **Intentos**: Máximo Y intentos (recomendado: 2-3 intentos)
Esto evita ser invasivo mientras mantiene el engagement del prospecto.
Ahora conecta cada salida del agente con los bloques correspondientes. Una vez conectadas las salidas, tu agente estará listo para recopilar información automáticamente.
***
## Maximiza el valor con bloques condicionales
Una vez que el agente recopila información, usa **bloques condicionales** para calificar automáticamente y tomar acciones específicas según el perfil de cada lead.
### Cómo funcionan los bloques condicionales
Los bloques condicionales evalúan la información recopilada y dirigen a cada lead por rutas personalizadas:
**Estructura básica del flujo de trabajo:**
```
Califica clientes potenciales → Bloque Condicional → Acción de CRM (opcional) → Bloque personalizado
```
**Ejemplo práctico en el Creador de Conversaciones:**
Arrastra un **bloque "Condiciones"** después de tu agente de calificación.
Configura la condición según los datos recopilados:
* **Propiedad**: Selecciona la variable del agente (ej. `presupuesto`, `ciudad`, `empresa`)
* **Operador**: Elige entre `contiene`, `es igual a`, `mayor que`, `menor que`, `diferente de`
* **Valor**: Define el criterio (ej. `$10,000`, `Ciudad de México`, `50 empleados`)
**Ejemplo**: Si `presupuesto` es `mayor que` `$10,000`
Conecta la salida del bloque condicional con un **bloque "Acción de CRM"**.
Actualiza propiedades en HubSpot/Salesforce:
* **Propiedad**: `estado_lead`
* **Valor**: `Calificado` o `No Calificado`
Esto permite que tengas trazabilidad en tu CRM y puedas activar flujos de trabajo específicos.
Conecta el bloque CRM con un **bloque de mensaje** específico para ese tipo de lead.
* **Prospecto calificado**: "¡Perfecto! Te contactará nuestro equipo comercial en las próximas 2 horas" Y luego redirección a un bloque de agente humano
* **Prospecto no calificado**: "Gracias por tu interés. Te mantendremos informado sobre nuevas opciones"
***
## Preguntas frecuentes
No. El agente solo recopila información. La calificación la haces después con bloques condicionales basados en los datos capturados.
Sí. Puedes editar el rol, preguntas y base de conocimientos en cualquier momento.
Sí. Las variables se guardan progresivamente, incluso si el usuario no termina.
Sí. Puedes usar diferentes agentes para recopilar distintos tipos de información.
Directamente solo HubSpot y Salesforce. Para otros CRM usa Variables de Treble y webhooks.
Sí. El agente puede **entender mensajes de voz enviados por los usuarios a través de WhatsApp** y responderá automáticamente con texto en la conversación.
***
## Solución de problemas
**Causas comunes:**
* Preguntas muy invasivas muy temprano
* Orden ilógico de preguntas
* Falta explicar por qué necesitas los datos
**Soluciones:**
* Comienza con preguntas básicas
* Explica el valor de cada dato solicitado
* Reordena según la lógica del usuario
**Causas comunes:**
* Variables mal configuradas
* Mapeo incorrecto de campos
* Formato incompatible
**Soluciones:**
* Verifica configuración en HubSpot/Salesforce
* Revisa mapeo de variables en Treble
* Prueba primero en Playground
**Causas comunes:**
* Proceso muy largo
* Preguntas irrelevantes
* Falta de valor percibido
**Soluciones:**
* Reduce preguntas esenciales
* Intercala con información de valor
* Explica beneficios de completar
## Consideraciones importantes
**Privacidad:** Informa a usuarios que sus datos serán guardados y cumple con regulaciones aplicables (GDPR, etc.).
# Logra un objetivo concreto
Source: https://help.treble.ai/es/docs/main-platform/ai-center/agents/objective-ai
Crea agentes IA que guían a tus contactos hacia objetivos específicos como agendar citas o realizar compras
**Este agente está en proceso de retiro.** En el creador de conversaciones el bloque aparece marcado como *Caduca pronto*. Los agentes que ya tienes creados siguen funcionando con normalidad, pero para agentes nuevos usa el [Agente de IA](/es/docs/main-platform/ai-center/agents/ai-agent/overview), que cubre este caso de uso y además puede ejecutar acciones con herramientas.
El agente **Logra un objetivo concreto** guía a tus contactos hacia una meta específica mediante conversaciones naturales. Responde preguntas, proporciona información y mantiene a los usuarios enfocados en completar la acción que deseas que realicen.
## ¿Es para ti?
* Guiar usuarios hacia una acción específica (clic, compra, agenda)
* Responder preguntas sobre productos/servicios antes de conversión
* Proporcionar información contextual durante el proceso
* Necesitas recopilar y guardar datos (usa [Califica clientes potenciales](/es/docs/main-platform/ai-center/agents/lead-qualification))
* Requieres transacciones complejas sin intervención humana
* Necesitas ejecutar acciones externas directamente (enviar emails, hacer llamadas)
## Casos de uso por industria
**Objetivo**: Agendar consultas médicas
**Guía al paciente respondiendo:**
* "¿Cuáles son sus horarios disponibles?"
* "¿Qué debo traer a la cita?"
* "¿Dónde están ubicados?"
**Resultado**: Más citas agendadas sin intervención del equipo administrativo
**Objetivo**: Completar compras en línea
**Guía al comprador respondiendo:**
* "¿Cuál es el precio de este producto?"
* "¿Hacen envíos a mi ciudad?"
* "¿Qué métodos de pago aceptan?"
**Resultado**: Menos abandono de carrito y mayor conversión en checkout
**Objetivo**: Agendar visitas a propiedades
**Guía al prospecto respondiendo:**
* "¿Qué propiedades tienen en \[zona]?"
* "¿Cuál es el precio por metro cuadrado?"
**Resultado**: Más visitas calificadas y menos tiempo en filtrado inicial
**Objetivo**: Solicitar información de programas
**Guía al estudiante respondiendo:**
* "¿Qué programas tienen disponibles?"
* "¿Cuál es la duración del curso?"
* "¿Hay opciones de financiamiento?"
**Resultado**: Leads mejor informados listos para inscripción
**Objetivo**: Agendar demos o iniciar trial
**Guía al prospecto respondiendo:**
* "¿Cómo funciona la plataforma?"
* "¿Qué integraciones tienen?"
* "¿Cuáles son los planes disponibles?"
**Resultado**: Más demos agendadas con prospectos calificados
***
## Configuración básica
En **"Primer Mensaje del Agente IA"**, puedes definir un mensaje inicial para saludar o dar contexto antes de que el usuario responda.
**Usa el botón "Dame un ejemplo"** para obtener una plantilla base.
**Ejemplo:**
```
Bienvenido a _______. ¿Cómo puedo ayudarte?
```
Si no defines un primer mensaje, el agente esperará a que el usuario inicie la conversación.
En **"Objetivo del Agente IA"**, indica la misión principal del agente.
**Usa el botón "Dame un ejemplo"** para obtener una plantilla base que puedes personalizar.
**Ejemplos de objetivos claros:**
* "Responder preguntas de tus clientes hasta que estén interesados en agendar una cita"
* "Ayudar al usuario a encontrar el producto ideal y dirigirlo al checkout"
* "Responder dudas sobre nuestros programas educativos hasta que solicite información detallada"
**Consejo:** Sé específico sobre la acción final que deseas lograr.
En **"Ajustes Generales"**, personaliza cómo se comporta el agente:
**1. ¿Qué empresa o producto representa el Agente IA?**
* Proporciona contexto sobre tu empresa o producto para que el agente responda con mayor precisión
**2. Estilo de Comunicación**
* Ajusta el slider entre **Casual** y **Profesional** según tu marca
* Casual: Ideal para B2C, servicios personales
* Profesional: Ideal para B2B, servicios corporativos
**3. Longitud de Respuesta**
* Ajusta entre **Texto Corto** y **Texto Largo**
* Corto: Respuestas concisas y directas
* Largo: Respuestas más detalladas y explicativas
**4. ¿Cuántas oportunidades tiene el Agente IA para lograr su objetivo?**
* Define el número de intentos o mensajes que tendrá el agente para lograr el objetivo
**5. Instrucciones Adicionales (opcional)**
* Instrucciones adicionales como: "usa muchos emojis", "usa expresiones del país \_\_\_\_", "compórtate como un asesor joven y relajado"
**Usa el botón "Dame un ejemplo"** para obtener ideas de instrucciones adicionales.
En **"Base de Conocimientos"**, sube archivos que ayuden al agente a responder preguntas específicas:
* Información básica (dirección, horarios, contacto)
* Productos o servicios detallados
* Precios y promociones
* Políticas importantes (garantías, devoluciones)
* Proceso específico para completar el objetivo
* Preguntas frecuentes
**Usa el botón "Generar un ejemplo"** para obtener una plantilla de contenido sugerido.
**Formatos soportados:** PDF, DOC, DOCX, PDF, PPT, PPTX, TXT (máximo 2MB por archivo, hasta 3 archivos).
En **"Reglas de Salida"**, verás las 3 salidas automáticas que tiene el agente:
1. **Objetivo Completado**: El usuario completó la acción deseada
2. **No Pudo Generar Respuesta / Alcanzó el Límite de Mensajes**: El agente no pudo generar respuesta o alcanzó el límite de mensajes
3. **Conversación Crítica**: El usuario está molesto o frustrado
No necesitas configurar nada aquí. Estas salidas se conectarán en el Creador de Conversaciones.
**Siempre** conecta la salida "Conversación Crítica" a un agente humano para evitar escalamiento de frustración.
**Haz clic en "Guardar"** para crear el agente. Una vez guardado, estará disponible para usar en el Creador de Conversaciones.
1. **Ve al Creador de Conversaciones** de tu proyecto
2. **Arrastra el bloque del agente que creaste** a tu flujo
3. **Selecciona tu agente** de la lista desplegable
El agente ahora está listo para interactuar con usuarios en ese flujo específico.
Ahora conecta cada salida del agente con los bloques correspondientes según el resultado:
**Objetivo Completado:**
* Conecta con un **mensaje de confirmación** ("¡Perfecto! Te contactaremos pronto")
* O con el **siguiente paso del proceso** (formulario, calendario, etc.)
**No Pudo Generar Respuesta / Alcanzó el Límite de Mensajes:**
* Conecta con **transfer a agente humano** para que retome la conversación
* O con un **mensaje de seguimiento** ofreciendo alternativas
**Conversación Crítica:**
* **Siempre** conecta con **transfer a agente humano** con prioridad alta
* Esto evita que usuarios frustrados abandonen o escalen su molestia
Una vez conectadas las salidas, tu agente estará listo para guiar usuarios hacia el objetivo automáticamente.
***
## Preguntas frecuentes
No. Cada agente debe enfocarse en **un solo objetivo específico**. Si tienes múltiples objetivos, crea un agente separado para cada uno.
No directamente. El agente puede guiar al usuario hacia un link de pago o checkout, pero no procesa transacciones.
Sí. Puedes editar el rol, objetivos y base de conocimientos en cualquier momento. Los cambios se aplican a nuevas conversaciones.
Sí. Si transfieres a un humano, el agente verá todo el historial de la conversación con el AI para dar mejor contexto.
Sí. El agente puede **entender mensajes de voz enviados por los usuarios a través de WhatsApp** y responderá automáticamente con texto en la conversación.
Sí. Usa bloques de **condiciones de tiempo** para activar el agente AI fuera de horario y transferir a humanos durante horario laboral.
El agente "logra un objetivo concreto" es una nueva versión del asistente IA. Aunque se comporta exactamente igual, ha tenido cambios en la arquitectura para mejorar su desempeño. Además, ha sido movido a Agentes de IA para ofrecer la posibilidad de reutilizar un agente en múltiples conversaciones y unificar la experiencia frente a otros agentes, como el de calificación de leads y el de automatización de tareas complejas.
***
## Solución de problemas
**Causas comunes:**
* El objetivo no está claramente definido en el rol
* Falta información sobre el proceso en la base de conocimientos
* Las instrucciones son demasiado generales
**Soluciones:**
* Reescribe el objetivo de manera más específica y medible
* Agrega pasos claros para completar la acción en la base de conocimientos
* Incluye ejemplos de cómo dirigir la conversación hacia el objetivo
**Causas comunes:**
* Base de conocimientos incompleta o desactualizada
* Información contradictoria en diferentes documentos
* Contexto insuficiente en los documentos
**Soluciones:**
* Revisa y actualiza tu base de conocimientos regularmente
* Elimina información duplicada o contradictoria
* Aplica las [mejores prácticas de documentación](/es/docs/main-platform/ai-center/knowledge-base)
**Causas comunes:**
* Conversaciones demasiado largas antes de llegar al objetivo
* Agente muy insistente con el objetivo
* No detecta cuando el usuario quiere hablar con humano
**Soluciones:**
* Simplifica el flujo hacia el objetivo (menos pasos)
* Agrega opciones de escape claras ("hablar con humano")
* Ajusta el tono para ser menos agresivo
* Mejora la detección de conversaciones críticas en el rol del agente
## Consideraciones importantes
**Mejores prácticas para el éxito:**
* Define un **objetivo único y específico** por agente - evita múltiples metas en un solo agente
* Incluye **información completa** en la base de conocimientos - entre más contexto, mejores resultados
* Usa **texto estructurado** en vez de imágenes o documentos escaneados
* Revisa las [mejores prácticas para base de conocimientos](/es/docs/main-platform/ai-center/knowledge-base) antes de comenzar
# Configura tu agente
Source: https://help.treble.ai/es/docs/main-platform/ai-center/configure-agent
Ajusta las instrucciones, completa las herramientas pendientes y define el comportamiento de tu agente antes de publicarlo.
El editor es donde revisas y terminas de armar el agente que generaste. Llegas con las instrucciones escritas y las herramientas elegidas, pero hay decisiones que solo tú puedes tomar: a qué agente derivar, qué variable usar, qué documento enviar.
El editor tiene tres áreas:
* **Instrucciones**, a la izquierda: el prompt completo del agente.
* **Herramientas** y **Base de conocimientos**, al centro: lo que el agente puede hacer y lo que sabe.
* **Playground**, a la derecha: el chat para probarlo sin salir de la pantalla.
## Ajusta las instrucciones
Las instrucciones son texto editable. Puedes reescribir lo que quieras, pero conviene respetar la estructura que generó Treble: identidad y voz, meta y límites, pasos a seguir, casos límite y reglas de salida.
Dentro del texto tienes dos atajos:
* Escribe `/` para abrir el menú de comandos rápidos e insertar una herramienta en el punto exacto donde quieres que se use.
* Escribe `{{` para insertar una variable guardada y usar su valor dentro de la conversación.
Cuando el agente no se comporte como esperas, casi siempre la solución es hacer las instrucciones más explícitas: agrega el caso que falló como un ejemplo concreto en lugar de reescribir todo el prompt.
## Completa las herramientas pendientes
Las herramientas aparecen como píldoras dentro de las instrucciones. Las que necesitan datos tuyos se muestran en amarillo, y arriba del editor verás un aviso del tipo **"Hay 4 herramientas pendientes de configuración"**.
Usa las flechas del aviso para recorrerlas una por una: cada clic te lleva a la siguiente píldora pendiente y abre su configuración. Por ejemplo, **Transferir a un agente** necesita que elijas la etiqueta de destino, y **Guardar respuesta** necesita el nombre de la variable donde guardar el dato.
No puedes publicar el agente mientras queden herramientas pendientes. Si intentas guardar antes de tiempo, Treble te lleva a las que faltan.
Las herramientas disponibles están agrupadas por categoría —Generales, Treble, HubSpot, Avanzado— y puedes agregar las que el generador no incluyó. Encuentras el detalle de cada una en la [introducción al Agente de IA](/es/docs/main-platform/ai-center/agents/ai-agent/overview).
## Revisa la base de conocimientos
En la pestaña **Base de conocimientos** están los archivos que adjuntaste durante la generación y el texto de contexto del agente. Puedes agregar más documentos, reemplazar los que quedaron desactualizados o escribir información directamente.
Antes de sumar material, revisa las [buenas prácticas para armar una base de conocimientos](/es/docs/main-platform/ai-center/knowledge-base): la calidad de estos documentos define la calidad de las respuestas.
## Define qué pasa si el contacto no responde
Arriba de las instrucciones encuentras la pregunta **"¿Qué debe hacer el Agente IA si el contacto no responde?"**. Ahí defines un tiempo de espera y la acción que se ejecuta cuando se cumple:
* **Cerrar conversación**: termina la interacción y la marca como resuelta.
* **Enviar conversación**: envía el contacto a otra conversación de Treble.
* **Transferir a un agente**: deriva el chat a un agente humano.
Configúralo siempre. Sin esta regla, una conversación que el contacto abandona queda abierta de forma indefinida.
## Guarda tu agente
Cuando no queden herramientas pendientes, guarda el agente con el botón de la esquina superior derecha. Desde ahí puedes crear una conversación de prueba y enviártela por WhatsApp.
Si cierras el editor con cambios sin guardar, Treble los conserva. La próxima vez que entres verás el aviso **"Tienes cambios sin guardar de una sesión anterior"** con la opción de recuperarlos.
## Siguientes pasos
Valida el comportamiento en el playground y envíate una conversación de prueba por WhatsApp.
Consulta el detalle de cada herramienta y cómo escribir instrucciones desde cero.
# Crea un agente
Source: https://help.treble.ai/es/docs/main-platform/ai-center/create-agent
Describe lo que necesitas en tus propias palabras y Treble escribe las instrucciones, elige las herramientas y arma tu agente IA.
Para crear un agente IA no necesitas escribir un prompt desde cero. Entra a **Agentes de IA**, describe en una frase lo que quieres que haga, responde algunas preguntas y Treble genera el agente por ti.
El generador escribe un primer borrador muy sólido, pero sigue siendo un borrador. Revísalo, ajústalo y pruébalo antes de conectarlo a una conversación real.
## Empieza con una descripción o una plantilla
En la caja de texto escribe qué quieres que haga tu agente. Mientras más claro seas, menos preguntas tendrás que responder después.
Una buena descripción incluye:
* **El objetivo**: qué tiene que lograr el agente.
* **Con quién habla**: prospectos, clientes actuales, alumnos, pacientes.
* **Qué información necesita recopilar**: nombre, correo, presupuesto, producto de interés.
* **Dónde termina la conversación**: derivar a ventas, agendar una cita, cerrar el caso.
Por ejemplo: *"Somos una empresa que vende cursos online. Necesito un agente para calificar a mis potenciales alumnos, recopilar nombre, email y carrera de interés, y derivarlos al equipo de ventas."*
Si prefieres partir de algo armado, elige una de las cuatro plantillas y edítala:
| Plantilla | Para qué sirve |
| --------------------- | ------------------------------------------------------- |
| **Califica leads** | Evalúa interés, presupuesto y tiempos de entrega. |
| **Agenda citas** | Coordina y confirma reuniones con tus prospectos. |
| **Chat de soporte** | Resuelve preguntas frecuentes y escala las complejas. |
| **Recupera carritos** | Retoma el contacto con quienes no terminaron su compra. |
Debajo de la caja de texto encuentras **Todos tus agentes**, la lista de los agentes que ya creaste con sus conversaciones asociadas y su última actividad. Desde ahí puedes buscarlos, editarlos o eliminarlos.
## Responde las preguntas del generador
Una vez que envías tu descripción, el generador te hace preguntas para cerrar los detalles que faltan: qué resultado concreto esperas, qué datos debe recopilar, a qué equipo derivar, qué hacer cuando el contacto se sale del tema.
Algunas preguntas llegan con opciones para elegir y otras esperan que escribas la respuesta. Si ninguna opción te sirve, usa **Otro...** y explícalo con tus palabras.
Responde con ejemplos reales de tu operación en lugar de generalidades. "Derivar a ventas cuando tenga nombre, email y carrera de interés" produce un agente mucho mejor que "calificar bien a los leads".
## Adjunta tus propios archivos
Durante la conversación puedes adjuntar archivos con el botón **+**: un PDF con tu catálogo, una lista de precios, un guion de atención o las preguntas frecuentes de tu equipo.
Cada archivo puede usarse de tres formas y el generador te confirma cuál va a aplicar:
* **Contexto de la conversación**: le sirve al generador para entender tu negocio mientras arma el agente, pero no queda disponible durante las conversaciones con tus clientes.
* **Base de conocimientos**: queda guardado en el agente para que pueda responder preguntas sobre su contenido.
* **Ambos**: se usa para armar el agente y además queda en la base de conocimientos.
Puedes adjuntar hasta 5 archivos. Si quieres agregar más material después, puedes hacerlo desde la pestaña **Base de conocimientos** del editor.
## Revisa el plan antes de generar
Cuando el generador tiene todo lo que necesita, te muestra un plan con lo que va a hacer tu agente: su propósito, el objetivo, las acciones que va a ejecutar y las restricciones que va a respetar.
Desde ahí tienes dos caminos:
Confirmas el plan y el generador escribe el agente. Toma alrededor de un minuto: primero redacta las instrucciones, después revisa su propia calidad y por último las mejora.
Le explicas qué corregir y el generador rehace el plan con tus ajustes. Puedes repetirlo las veces que necesites: nada se crea hasta que confirmas.
## Qué obtienes al terminar
Cuando la generación termina llegas al editor con el agente ya armado:
* **Nombre y descripción** propuestos a partir de lo que pediste.
* **Instrucciones completas**, con el tono, el alcance, los pasos y los casos límite.
* **Herramientas sugeridas** según lo que el agente tiene que hacer.
* **Base de conocimientos** con los archivos que marcaste para ese uso.
Las herramientas que necesitan datos tuyos quedan marcadas como pendientes de configuración. Ese es el siguiente paso.
## Siguientes pasos
Ajusta las instrucciones, completa las herramientas pendientes y define qué hacer si el contacto no responde.
Valida el comportamiento en el playground y envíate una conversación de prueba por WhatsApp.
# Base de conocimientos
Source: https://help.treble.ai/es/docs/main-platform/ai-center/knowledge-base
Aprende cómo estructurar una base de conocimientos efectiva para maximizar el rendimiento de tus agentes IA
Tu agente IA es tan inteligente como la información que le proporcionas. Una base de conocimientos bien estructurada es la diferencia entre un agente que confunde a tus clientes y uno que los convierte en compradores satisfechos.
Los archivos que adjuntas mientras [creas un agente](/es/docs/main-platform/ai-center/create-agent) y marcas como base de conocimientos se cargan aquí automáticamente. Todo lo de esta página sigue aplicando: revisa que ese material cumpla las buenas prácticas y complétalo desde la pestaña **Base de conocimientos** del editor.
## ¿Por qué es tan importante?
**🎯 Respuestas precisas desde el día 1**
* Evita respuestas inventadas o incorrectas
* Proporciona información consistente 24/7
* Reduce la necesidad de intervención humana
**📈 Mejores resultados de conversión**
* Clientes más informados toman mejores decisiones
* Aumenta la confianza en tu marca
**⚡ Implementación más rápida**
* Agentes listos para producción en menos tiempo
* Menos iteraciones y ajustes posteriores
* ROI más rápido de tu inversión en IA
**Piensa en tu agente IA como un nuevo miembro del equipo**: necesita la misma información, procedimientos y contexto que le darías a cualquier empleado para ser exitoso.
## 📋 Checklist rápido: ¿Está lista tu base de conocimientos?
Antes de empezar, verifica que tienes:
* Información básica de la empresa (dirección, horarios, contacto)
* Descripción clara de productos/servicios principales
* Precios y promociones actuales
* Políticas importantes (garantía, devoluciones, envíos)
* Preguntas frecuentes de tus clientes reales
* Casos de éxito y testimonios
* Comparativas con competencia
* Procesos internos simplificados
* Scripts de manejo de objeciones
* Criterios de calificación de leads
* Archivos en formatos legibles (.docx, .txt, .pdf digital)
* Texto seleccionable (no escaneado)
* Documentos organizados por tema
* Versiones actualizadas únicamente
* Nombres de archivo descriptivos con fechas
***
## 🔧 Mejores prácticas por categoría
Nuestra IA solo puede leer texto digital, no imágenes ni archivos escaneados.
**✅ Formatos recomendados:**
* `.docx` - Microsoft Word (ideal para contenido estructurado)
* `.txt` - Texto plano (perfecto para información simple)
* `.md` - Markdown (excelente para documentación técnica)
* `.pdf` - Solo si el texto es seleccionable (no escaneado)
**🧪 Prueba rápida:** ¿Puedes seleccionar y copiar el texto? Si sí, funcionará.
**❌ Evita estos formatos:**
* PDFs escaneados o convertidos desde papel
* Capturas de pantalla o fotos de documentos
* Imágenes con texto incrustado
* Documentos protegidos con contraseña
**Regla de oro:** Un tema = Un archivo. La IA procesa mejor información organizada que documentos masivos.
**📁 Estructura recomendada:**
```
📁 Base de conocimientos/
├── 📄 Información-empresa-2024.docx
├── 📄 Productos-principales-2024.docx
├── 📄 Políticas-garantía-2024.docx
├── 📄 Preguntas-frecuentes-2024.docx
└── 📄 Precios-promociones-2024.docx
```
**✅ Dentro de cada documento:**
* Título claro y descriptivo
* Tabla de contenidos (si tiene +3 secciones)
* Encabezados jerárquicos (H1, H2, H3)
* Información completa en cada sección
**❌ Evita:**
* Documentos gigantes que mezclan todo
* Títulos ambiguos como "Info.docx"
* Saltar niveles de encabezado (H1 → H3)
* Referencias a "lo anterior" o "como se mencionó"
**Principio clave:** Cada párrafo debe funcionar independientemente. La IA puede leer fragmentos aislados.
**🎯 Contexto completo siempre:**
* Incluye nombres específicos, fechas, lugares
* No uses referencias como "esto", "lo anterior", "como se mencionó"
* Cada frase debe ser autosuficiente
**Ejemplos de redacción:**
✅ **Excelente:**
> "La garantía de smartphones Xiaomi cubre defectos de fábrica por 12 meses desde la compra en México, excluyendo daños por agua o golpes."
❌ **Problemático:**
> "Tiene 12 meses de cobertura, pero no incluye daños externos."
**📝 Lenguaje claro y consistente:**
* Frases cortas y directas (máximo 25 palabras)
* Un término por concepto ("cliente" O "usuario", no ambos)
* Define acrónimos: "CRM (Customer Relationship Management)"
* Evita jerga técnica sin explicación
**Truco rápido:** Lee cada párrafo fuera de contexto. ¿Se entiende completamente? Si no, agrega más contexto.
**Por qué es importante:** La IA aprende patrones. Documentos con estructura similar mejoran la precisión de las respuestas.
**🛠️ Plantilla para fichas de producto:**
```
# [Nombre del Producto]
## Descripción general
[Qué es y para qué sirve]
## Especificaciones técnicas
[Características detalladas]
## Precios y disponibilidad
[Información actual de precios]
## Preguntas frecuentes
[3-5 preguntas reales de clientes]
## Contacto y soporte
[Cómo obtener ayuda específica]
```
**🏢 Plantilla para información de empresa:**
```
# [Nombre de la Empresa]
## ¿Quiénes somos?
## Servicios principales
## Ubicación y horarios
## Métodos de contacto
## Políticas importantes
```
Crea un documento maestro con tu plantilla y duplicalo para cada nuevo contenido. Esto garantiza consistencia automática.
**Estrategia ganadora:** Incluye las preguntas REALES que hacen tus clientes, no las que crees que deberían hacer.
**📋 Formato recomendado:**
```
## Preguntas frecuentes
**P: ¿Hacen envíos los fines de semana?**
R: Realizamos envíos de lunes a viernes. Los pedidos del viernes se procesan el lunes siguiente.
**P: ¿Puedo cancelar mi pedido?**
R: Puedes cancelar sin costo hasta 2 horas después de confirmar tu pedido llamando al 555-0123.
```
**🎯 Fuentes de preguntas reales:**
* Chat de atención al cliente
* Emails de soporte recibidos
* Comentarios en redes sociales
* Preguntas de vendedores frecuentes
**❌ Evita respuestas vagas:**
* "Depende de cada caso"
* "Contacta para más información"
* "Según disponibilidad"
Actualiza las FAQs cada mes con nuevas preguntas reales. Una base de conocimientos actualizada = mejores conversiones.
**Problema común:** La IA no distingue entre versiones. Si encuentra información conflictiva, puede mezclar respuestas incorrectas.
**🎯 Estrategia de fuente única:**
* Un dato = Un lugar
* Elimina versiones antiguas antes de subir nuevas
* Usa nombres de archivo con fechas para control de versiones
**Ejemplos problemáticos:** ❌ `garantia-v1.pdf` dice 6 meses ❌ `garantia-final.pdf` dice 12 meses ❌ `garantia-actualizada.pdf` dice 24 meses
**Resultado:** La IA podría responder "entre 6 y 24 meses" 😱
**✅ Solución:**
* Solo mantén: `garantia-marzo-2025.pdf` con información actualizada
* Elimina todas las versiones anteriores
Antes de subir un documento actualizado, elimina la versión anterior de la base de conocimientos. La IA no puede distinguir cuál es la versión "correcta".
**Regla de oro:** Una base de conocimientos desactualizada es peor que no tener base de conocimientos.
**📅 Calendario de mantenimiento recomendado:**
**Cada semana:**
* Revisa preguntas nuevas de clientes
* Actualiza promociones o precios temporales
**Cada mes:**
* Audita respuestas del agente IA
* Agrega nuevas FAQs identificadas
* Verifica vigencia de políticas
**Cada trimestre:**
* Revisión completa de toda la base
* Elimina información obsoleta
* Actualiza información de contacto y horarios
**🎯 Indicadores de que necesitas actualizar:**
* Clientes mencionan información incorrecta
* Cambios en productos, precios o políticas
* Nuevas preguntas frecuentes no contempladas
* Agente no puede responder temas actuales
**Nombra tus archivos con fechas:** `precios-enero-2025.pdf` es mejor que `precios-nuevos.pdf`. Te ayudará a identificar qué necesita actualización.
***
## 🏢 Guías específicas por industria
Cada sector tiene información crítica que tus agentes DEBEN conocer para ser efectivos:
**Información esencial:**
* Horarios específicos por especialidad
* Procedimientos disponibles y requisitos
* Costos aproximados y métodos de pago
* Tiempos de espera típicos
* Ubicación exacta y estacionamiento
* Políticas de cancelación/reagendamiento
**Ejemplo optimizado:**
> "La Dra. López (cardiología) atiende martes y jueves de 9:00 AM a 1:00 PM en Consulta 205. Costo de consulta: \$800 MXN. Requiere referencia médica. Estacionamiento gratuito disponible."
**Información esencial:**
* Inventario actual con precios exactos
* Características detalladas de propiedades
* Zona/ubicación con puntos de referencia
* Proceso de compra/renta paso a paso
* Requisitos financieros y documentación
* Costos adicionales (mantenimiento, servicios)
**Ejemplo optimizado:**
> "Casa en Polanco, 3 habitaciones, 2 baños, 120m². Precio: 2,500/mes. Enganche mínimo: 30%. Disponible para entrega inmediata."
**Información esencial:**
* Fechas exactas de inscripción y inicio
* Requisitos académicos específicos
* Costos desglosados (colegiatura, materiales, extras)
* Modalidades disponibles (presencial, virtual, mixta)
* Horarios por programa/nivel
* Proceso de admisión completo
**Ejemplo optimizado:**
> "Maestría en Marketing Digital: Inicio 15 enero 2025. Modalidad mixta (sábados presenciales 8-14hrs + clases virtuales martes 19-21hrs). Costo: \$48,000 semestrales. Requisito: licenciatura en áreas afines."
**Información esencial:**
* Inventario en tiempo real
* Precios con descuentos aplicables
* Métodos de pago aceptados
* Políticas de envío detalladas
* Garantías y políticas de devolución
* Comparativas con productos similares
**Ejemplo optimizado:**
> iPhone 15 Pro 256GB disponible en azul y negro. Precio: \$25,999 MXN (12 meses sin intereses). Envío gratis en CDMX (24-48hrs). Garantía Apple 1 año + seguro contra robo opcional \$299
**Información esencial:**
* Modelos disponibles con especificaciones
* Precios finales (con impuestos)
* Planes de financiamiento
* Garantías específicas por componente
* Servicios de mantenimiento incluidos
* Ubicación de agencias/talleres
**Ejemplo optimizado:**
> Nissan Versa 2024 Sense MT: \$259,900 MXN precio final. Garantía motor 5 años/100,000km. Financiamiento desde \$4,890/mes a 60 meses. Mantenimiento gratuito primeros 2 servicios. Disponible en agencia Satélite.
## 🚀 Próximos pasos para implementar
Usa el checklist inicial para identificar qué información te falta.
Aplica las recomendaciones específicas de tu sector.
Estructura la información usando las plantillas sugeridas.
Testea tu agente IA y ajusta la base según los resultados.
**¿Necesitas ayuda específica?** Cada industria tiene matices únicos. Si tu sector no está cubierto aquí, aplica los principios generales y enfócate en las preguntas más frecuentes de tus clientes reales.
# Introducción
Source: https://help.treble.ai/es/docs/main-platform/ai-center/overview
Crea agentes IA describiendo lo que necesitas y automatiza tus conversaciones de WhatsApp de punta a punta.
En **Agentes de IA** creas y editas los agentes de inteligencia artificial que se integran en tus flujos conversacionales de WhatsApp. Describes en una frase lo que quieres que haga tu agente, respondes algunas preguntas y Treble escribe las instrucciones, elige las herramientas y lo deja listo para que lo revises.
## ¿Por qué usar agentes IA en tus conversaciones?
Los agentes IA de Treble transforman la manera en que interactúas con tus clientes potenciales, ofreciendo beneficios inmediatos:
**🚀 Mejora la experiencia del cliente:**
* Respuestas instantáneas 24/7, sin esperas
* Conversaciones más fluidas y naturales
**📈 Aumenta tus conversiones:**
* Reduce el abandono con atención inmediata
* Califica automáticamente a tus mejores prospectos
* Guía a los usuarios hacia acciones específicas
**⏰ Optimiza tu tiempo:**
* Automatiza tareas repetitivas de calificación
* Libera a tu equipo para conversaciones de mayor valor
* Captura información clave sin intervención manual
Los agentes IA necesitan contexto específico sobre tu empresa, productos y procesos para funcionar correctamente. Cuanta más información de calidad proporciones, mejores resultados obtendrás.
## El Agente de IA
El **Agente de IA** es el agente con el que construyes en Treble. Mantiene una conversación natural, sigue las reglas que definiste en sus instrucciones y ejecuta acciones con herramientas: guarda datos, consulta y actualiza tu CRM, envía documentos, deriva a un agente humano o cierra la conversación.
Automatiza procesos con múltiples caminos posibles. Llama herramientas, aplica reglas condicionales y escala conversaciones según las necesidades de tu negocio.
[Ver guía completa →](/es/docs/main-platform/ai-center/agents/ai-agent/overview)
### Casos de uso
* 🎯 **Calificación de leads**: recopila los datos que te importan y deriva a ventas cuando el prospecto cumple tus criterios
* 🔄 **Consultas de cuenta**: lee propiedades de HubSpot para informar sobre plan actual, fecha de renovación y estado de suscripción
* 🎫 **Gestión de tickets**: crea y actualiza tickets automáticamente según las solicitudes del usuario
* 📊 **Actualización de datos**: modifica propiedades de contacto en tu CRM basándose en la conversación
* 🛒 **Soporte y pre-venta**: resuelve preguntas frecuentes con tu base de conocimientos y escala los casos complejos
* 📅 **Agendamiento**: coordina disponibilidad, confirma horarios y registra la cita
* 🔀 **Flujos condicionales**: ejecuta diferentes acciones según el estado del cliente o el tipo de solicitud
Los agentes **Logra un objetivo concreto** y **Califica clientes potenciales** están en proceso de retiro y aparecen marcados como *Caduca pronto* en el creador de conversaciones. Los que ya tienes creados siguen funcionando, pero para agentes nuevos usa el **Agente de IA**, que cubre ambos casos y hace más.
## Cómo crear un agente
En **Agentes de IA** escribe qué quieres que haga tu agente, o parte de una plantilla.
El generador te pregunta lo que le falta y te propone un plan para que lo confirmes.
Llegas al editor con las instrucciones y las herramientas listas. Configuras las que necesitan datos tuyos.
Validas el comportamiento en el playground y te envías una conversación de prueba por WhatsApp.
## Usar tu agente en una conversación
Una vez guardado, integras el agente en tus flujos conversacionales:
Accede desde tu dashboard principal al creador de flujos.
Lo encuentras en la sección de bloques avanzados de la barra lateral.
Elige el agente que creaste de la lista desplegable.
Arrastra y conecta el bloque con el resto de tu flujo conversacional.
Define qué sucede según los diferentes resultados del agente.
* Puedes usar más de un agente IA en la misma conversación y combinarlos con bloques condicionales para crear experiencias más sofisticadas.
## Próximos pasos
Describe lo que necesitas y deja que Treble arme el primer borrador.
Revisa las mejores prácticas antes de cargar tu información.
Ajusta las instrucciones y completa las herramientas pendientes.
Valida el comportamiento antes de conectarlo a una conversación real.
# Prueba tu agente
Source: https://help.treble.ai/es/docs/main-platform/ai-center/playground
Valida y optimiza tu agente IA en el playground y con una conversación real de WhatsApp antes de ponerlo en producción.
Antes de conectar tu agente a una conversación real tienes dos formas de probarlo: el **Playground**, el chat que vive a la derecha del editor, y una **conversación de prueba** que te llega a tu propio WhatsApp.
## ¿Por qué usar el Playground?
**🚀 Validación rápida sin necesidad de enviar un flujo por WhatsApp**
* Prueba conversaciones completas en segundos
* No necesitas enviar mensajes reales de WhatsApp
* Experimenta sin límites hasta estar satisfecho
**🔍 Encuentra problemas antes que tus clientes**
* Identifica respuestas confusas o incorrectas
* Detecta lagunas en tu base de conocimientos
* Prueba escenarios difíciles y objeciones
**Importante:** El Playground solo prueba la lógica conversacional del agente. Las integraciones con CRM no se ejecutan aquí. Necesitarás probar esas funciones con una conversación real de WhatsApp.
## 🎯 Metodología de prueba en 5 pasos
### **Paso 1: Prueba el flujo básico (Happy Path)**
Simula un cliente ideal que sigue el flujo previsto:
**Escenario:** un contacto que sigue el camino previsto de principio a fin
```
TÚ: "Hola, me interesa información"
AGENTE: [Saludo y primera pregunta]
TÚ: "Mi nombre es Juan Pérez"
AGENTE: [Confirma y pregunta lo siguiente]
TÚ: "juan@email.com"
AGENTE: [Siguiente pregunta]
[Continúa hasta que el agente cierre o derive la conversación]
```
**✅ Verifica que el agente:**
* Hace las preguntas en un orden lógico y una a la vez
* Confirma la información que recibe
* Usa las herramientas correctas en el momento correcto
* Cierra o deriva la conversación según las reglas que definiste
* Mantiene un tono apropiado de principio a fin
### **Paso 2: Prueba escenarios reales de clientes**
Simula comportamientos típicos de tus clientes:
**Cómo actuar:**
* Haz preguntas vagas: "¿Me puedes ayudar?"
* Solicita comparaciones: "¿Qué es mejor, A o B?"
* Muestra dudas: "No estoy seguro si esto es para mí"
**¿Qué evaluar?**
* El agente clarifica necesidades específicas
* Proporciona comparaciones útiles
* Maneja la incertidumbre sin presionar
**Cómo actuar:**
* Usa frases cortas: "Precio", "Horarios", "Disponibilidad"
* Interrumpe explicaciones: "Solo dime el costo"
* Indica urgencia: "Necesito esto ya"
**¿Qué evaluar?**
* Respuestas concisas y directas
* Información esencial primero
* No sobreexplica cuando no se pide
**Cómo actuar:**
* Pregunta precios inmediatamente
* Compara con competencia: "En X lugar es más barato"
* Busca descuentos: "¿Tienen promociones?"
**¿Qué evaluar?**
* Maneja objeciones de precio apropiadamente
* Destaca valor, no solo precio
* Ofrece alternativas cuando es relevante
**Cómo actuar:**
* Evita dar información personal
* Hace muchas preguntas antes de decidir
* Expresa desconfianza: "¿Es seguro esto?"
**¿Qué evaluar?**
* Respeta la privacidad del usuario
* Proporciona información de seguridad
* Genera confianza progresivamente
### **Paso 3: Prueba casos extremos y objeciones**
Los escenarios difíciles revelan debilidades:
**🚫 Pruebas de límites:**
```
❌ "Esto es muy caro, ¿tienen algo gratis?"
❌ "No entiendo nada de lo que dices"
❌ "Quiero hablar con un humano YA"
❌ "¿Por qué necesitan mi información personal?"
```
**✅ Evalúa si el agente:**
* Maneja objeciones sin ser insistente
* Explica claramente cuando no entiende
* Respeta decisiones del usuario
### **Paso 4: Valida tu base de conocimientos**
Haz preguntas específicas de tu negocio:
* ¿Cuáles son sus horarios de atención?
* ¿Dónde están ubicados?
* ¿Cuáles son sus métodos de pago?
* ¿Hacen entregas/envíos?
* ¿Tienen garantía?
* Pregunta por productos/servicios específicos
* Solicita especificaciones técnicas
* Pregunta por compatibilidades o requisitos
* Consulta sobre procesos internos
* Pide comparaciones entre opciones
* Situaciones que requieren múltiples fuentes de información
* Preguntas que combinan varios temas
* Escenarios que tu competencia maneja diferente
* Casos especiales o excepciones
* Preguntas sobre actualizaciones recientes
### **Paso 5: Optimización iterativa**
**🔄 Proceso de mejora continua:**
Anota respuestas incorrectas, confusas o incompletas durante las pruebas.
Agrega información faltante o clarifica contenido ambiguo.
Usa "Reiniciar chat" y repite los escenarios problemáticos.
Confirma que los problemas identificados se han resuelto.
**Reinicia la conversación después de cada cambio**: El botón "Reiniciar chat" limpia toda la sesión. Úsalo cada vez que modifiques la configuración del agente para probar los cambios.
## Señales de que necesitas más optimización
**🔴 Problemas críticos:**
* Respuestas incorrectas sobre información básica
* No puede guiar hacia el objetivo principal
* Proporciona información contradictoria
* Se confunde con preguntas simples
**🟡 Áreas de mejora:**
* Respuestas demasiado largas o cortas
* Dificultad con jerga o términos específicos
* No maneja bien las objeciones
* Falta información sobre casos especiales
**🟢 Listo para producción:**
* Responde consistentemente bien en todos los escenarios
* Maneja casos extremos profesionalmente
* Proporciona valor claro en cada interacción
* Los usuarios pueden lograr sus objetivos fácilmente
## ⚡ Consejos para pruebas eficientes
**Simula personalidades reales**: Piensa en 3-4 tipos de clientes típicos que tienes y actúa como cada uno de ellos durante las pruebas.
**Documenta los problemas**: Mantén una lista de respuestas problemáticas para poder corregirlas sistemáticamente.
## Envíate una conversación de prueba por WhatsApp
El Playground no ejecuta las integraciones. Para verificar que todo funciona de punta a punta, envíate el agente a tu propio número.
Después de guardar el agente, elige **Ir a crear conversación**. Treble arma una conversación saliente con tu agente ya conectado.
Las conversaciones salientes necesitan una plantilla aprobada por Meta para iniciar el contacto. Puedes usar una tuya o la que Treble crea por defecto.
Escribe el número de WhatsApp donde quieres recibir la conversación y envíala.
Responde como lo haría un cliente real y valida el flujo completo.
Si usas HubSpot o Salesforce, confirma que los datos se guardaron correctamente y que los tickets o transferencias se ejecutaron.
La conversación de prueba queda guardada en la sección **Conversaciones**, así que puedes volver a enviarla las veces que necesites mientras ajustas el agente.
## Próximos pasos
¿Tu agente ya está funcionando bien en el Playground? Es hora de:
1. [**Usar tu agente en una conversación**](/es/docs/main-platform/ai-center/overview) - Integra tu agente en flujos de WhatsApp
2. [**Optimizar tu base de conocimientos**](/es/docs/main-platform/ai-center/knowledge-base) - Mejora la calidad de las respuestas
3. [**Revisar el detalle del Agente de IA**](/es/docs/main-platform/ai-center/agents/ai-agent/overview) - Herramientas disponibles y cómo ajustar las instrucciones
# Centro de métricas
Source: https://help.treble.ai/es/docs/main-platform/analytics-center
El Centro de Métricas es el lugar donde puedes explorar y acceder a datos estructurados sobre tu actividad de WhatsApp en Treble. Está diseñado para los equipos que desean mayor autonomía y claridad al comprender la interacción de los usuarios, la efectividad de las campañas y el rendimiento operativo.
Esta página presenta dos tablas de datos fundamentales: Sesiones y Despliegues. Estas tablas están disponibles mediante una pestaña dedicada en la plataforma de Treble. Cada una está completamente documentada con descripciones detalladas de sus campos para ayudarte a crear paneles eficaces, realizar análisis significativos y tomar decisiones informadas basadas en datos.
Solo puedes descargar datos en intervalos de hasta 30 días.
La extracción de datos está disponible desde el **15 de abril de 2025**.
El **Centro de Métricas** brinda a tu equipo acceso directo a datos estructurados sobre tus sesiones de WhatsApp y los despliegues de campañas. En lugar de depender de informes manuales o tickets de soporte, ahora puedes explorar tus propios datos para responder preguntas clave sobre el rendimiento de las campañas, el comportamiento de los usuarios y la eficiencia operativa.
**Sesiones** y **Despliegues** son dos tablas limpias y bien documentadas a las que se accede desde una nueva pestaña en la plataforma de Treble. Estas tablas contienen los datos fundamentales que necesitas para crear tus propios paneles, hacer seguimiento de resultados y tomar decisiones más rápidas e informadas.
**¿Qué es una Sesión?**
Una sesión es un período de interacción definido por Treble, distinto de la ventana de atención al cliente de 24 horas que aplica WhatsApp Business. Comienza cuando un usuario envía o recibe un mensaje que inicia una conversación en Treble y termina cuando ocurre uno de los siguientes eventos:
* La conversación se redirige a otro flujo.
* La sesión se cierra tras un período de inactividad.
* Un agente la cierra manualmente.
* El flujo (también llamado conversación o *poll*) se sobrescribe.
* Se envía al usuario otro flujo (conversación o *poll*).
Si el usuario vuelve después de que una sesión haya finalizado, su nueva interacción aparecerá como una sesión aparte.
Las sesiones capturan el contexto completo de la interacción del usuario durante ese período, incluidos los mensajes automatizados, las interacciones con agentes y los metadatos de las fuentes de marketing. Son la unidad básica para analizar el comportamiento, medir el desempeño de los flujos y entender cómo los usuarios interactúan con tus campañas.
**Tabla de Sesiones:**
1. **ID de sesión:** `{{session_id}}` Identificador único que distingue cada sesión. Una sesión es un período continuo de interacción entre un usuario y la comunicación de WhatsApp iniciada a través de Treble. Comienza cuando el usuario envía o recibe un mensaje que inicia una conversación y finaliza cuando la sesión es redirigida, se cierra por inactividad o un agente la cierra manualmente. Si el usuario regresa más tarde, se creará una nueva sesión.
2. **ID de sesión padre**: `{{parent_session_id}}` Identificador único de la sesión anterior cuando la sesión actual se creó mediante una redirección. Esto suele ocurrir cuando un usuario es redirigido de un flujo de conversación (poll) a otro.
3. **Fecha y hora de inicio de sesión**: `{{session_started_timestamp}}` Fecha y hora en las que comenzó la sesión con el usuario.
4. **Fecha y hora de fin de sesión**: `{{session_finished_timestamp}}` Fecha y hora en las que finalizó la sesión con el usuario.
5. **Tipo de sesión**: `{{session_type}}` Indica cómo se inició la conversación. Puede ser:
* **Outbound**: La sesión fue iniciada por una campaña automatizada enviada desde Treble como parte de una estrategia de contacto proactivo.
* **Inbound**: La sesión fue iniciada por el usuario, quien escribió primero sin haber recibido recientemente un mensaje de Treble.
6. **Estado de la sesión**: `{{session_status}}` Indica la etapa o condición actual de la conversación dentro de la sesión. Ayuda a entender el progreso de la interacción y quién la gestiona. Valores posibles:
* **BOT**: La conversación está siendo gestionada por un flujo automatizado.
* **AGENTS**: La conversación ha sido transferida a un agente humano.
* **RATING**: La sesión terminó y al usuario se le solicitó calificar su experiencia.
7. **ID de conversación**: `{{conversation_id}}` Identificador único del flujo o poll donde tuvo lugar la sesión.
8. **Versión de conversación**: `{{conversation_version}}` Número de versión del flujo o poll activo durante la interacción.
9. **Código de país del usuario**: `{{user_country_code}}` Código telefónico internacional del número del usuario en la sesión. Ayuda a identificar el país de origen del número.
10. **Teléfono celular del usuario**: `{{user_cellphone}}` Número de WhatsApp del usuario que participó en la sesión.
11. **Número de línea de WhatsApp**: `{{line_whatsapp_number}}` Número de la línea de WhatsApp Business utilizada para comunicarse con el usuario.
12. **Nombre de visualización de la línea de WhatsApp**: `{{line_whatsapp_display_name}}` Nombre de visualización configurado para la línea de WhatsApp Business utilizada durante la sesión.
13. **Fecha y hora del primer mensaje**: `{{first_message_timestamp}}` Fecha y hora en las que se recibió el primer mensaje del usuario durante la sesión.
14. **Primer mensaje**: `{{first_message}}` Contenido del primer mensaje enviado por el usuario durante la sesión. Solo aparece si el mensaje fue de texto.
15. **Fecha y hora del último mensaje**: `{{last_message_timestamp}}` Fecha y hora en las que el usuario envió su último mensaje durante la sesión.
16. **Último mensaje**: `{{last_message}}` Contenido del último mensaje enviado por el usuario durante la sesión. Solo aparece si el mensaje fue de texto.
17. **ID del último nodo**: `{{last_node_id}}` Identificador del último nodo del flujo alcanzado por el usuario durante la sesión.
18. **URL de fuente Meta**: `{{meta_source_url}}` URL del anuncio o publicación de Meta que originó la sesión mediante un clic a WhatsApp. Vacío si la sesión no se inició desde un anuncio de este tipo.
19. **Tipo de fuente Meta**: `{{meta_source_type}}` Tipo de contenido de Meta que originó la sesión mediante clic a WhatsApp. Puede ser Ad o Post. Vacío si la sesión no se inició desde dicho contenido.
20. **ID de fuente Meta**: `{{meta_source_id}}` Identificador único del anuncio o publicación de Meta que originó la sesión mediante clic a WhatsApp. Vacío si la sesión no se originó desde ese contenido.
21. **Titular de fuente Meta**: `{{meta_source_headline}}` Titular del anuncio o publicación de Meta que originó la sesión mediante clic a WhatsApp. Vacío si la sesión no se inició desde ese contenido.
22. **Cuerpo de fuente Meta**: `{{meta_source_body}}` Cuerpo del anuncio o publicación de Meta que originó la sesión mediante clic a WhatsApp. Vacío si la sesión no se originó desde ese contenido.
23. **Tipo de medio de fuente Meta**: `{{meta_source_media_type}}` Tipo de medio utilizado en el anuncio o publicación de Meta que originó la sesión (Imagen o Video). Vacío si la sesión no se originó desde ese contenido.
24. **URL de medio de fuente Meta**: `{{meta_source_media_url}}` URL del archivo de imagen o video utilizado en el anuncio o publicación de Meta que originó la sesión mediante clic a WhatsApp. Vacío si la sesión no se originó desde ese contenido.
25. **URL de miniatura de fuente Meta**: `{{meta_source_thumbnail_url}}` URL de la miniatura del medio utilizado en el anuncio o publicación de Meta que originó la sesión. Vacío si la sesión no se originó desde ese contenido.
26. **Nombre de campaña de enlace de WhatsApp**: `{{whatsapp_link_campaign_name}}` Nombre de la campaña asociada al enlace de WhatsApp que el usuario utilizó para iniciar la conversación. Solo se llena si la conversación se originó desde un enlace creado con la función de enlaces de WhatsApp de Treble..
27. **Fuente de campaña de enlace de WhatsApp:** `{{whatsapp_link_campaign_source}}` Plataforma o canal donde se utilizó el enlace de la campaña de WhatsApp (por ejemplo, Instagram, Facebook o Google). Solo tendrá valor si la conversación se originó desde un enlace creado con la función de enlaces de WhatsApp de Treble.
**¿Qué es un Despliegue?**
Un despliegue representa un intento de iniciar una conversación de WhatsApp con un usuario a través de una campaña saliente. Cada despliegue es un registro de cuándo se programó el envío de un mensaje, si se entregó exitosamente y cualquier sesión que haya generado.
Los despliegues permiten rastrear cómo y cuándo se contactó a los usuarios, si los mensajes fueron entregados y cómo esos mensajes se conectaron con las interacciones posteriores del usuario. Si un despliegue resulta en participación del usuario, estará vinculado a una sesión correspondiente.
**Tabla de Despliegues:**
1. **ID de conversación**: `{{conversation_id}}` Identificador único del flujo o poll utilizado en el despliegue. Este ID vincula el despliegue con la conversación específica que se envió al usuario.
2. **Versión de conversación**: `{{conversation_version}}` Número de versión del flujo o poll utilizado en el despliegue. Ayuda a identificar con precisión qué versión de la conversación estaba activa durante la interacción del usuario.
3. **Código de país del usuario**: `{{user_country_code}}` Código telefónico internacional del número del usuario al que se envió el despliegue. Indica el país asociado al número del destinatario.
4. **Teléfono celular del usuario:** `{{user_cellphone}}` Número de WhatsApp del usuario al que se dirigió el despliegue. Es el número al que se pretendía entregar el mensaje.
5. **Fecha y hora de inicio de despliegue**: `{{deployment_timestamp}}` Marca temporal que indica cuándo se inició el despliegue. Corresponde a la hora programada en la que se debía enviar el mensaje al usuario.
6. **Fecha y hora de respuesta del usuario**: `{{user_responded_timestamp}}` Marca temporal que indica cuándo el usuario responde por primera vez una conversación.
7. **Estado de despliegue:** `{{delivery_status}}` Estado actual del despliegue. Los valores posibles son:
* **In Process**: El mensaje se está enviando.
* **Delivered**: El mensaje se entregó correctamente al usuario.
* **Failed**: El mensaje no pudo entregarse debido a un error.
8. **Detalle del estado:** `{{status_detail}}` Motivo específico por el cual el despliegue falló. Este campo ofrece detalles del error que impidió la entrega del mensaje.
9. **Fecha y hora de entrega del despliegue**: `{{deployment_delivered_timestamp}}` Marca temporal que indica cuándo se entregó correctamente el mensaje al usuario. Solo se completa si la entrega fue exitosa.
10. **ID de sesión**: `{{session_id}}` Identificador asignado a la sesión creada cuando el despliegue se entregó correctamente. Una sesión es un período continuo de interacción entre el usuario y la comunicación de WhatsApp disparada por Treble. Si el despliegue falló o aún está en proceso, no se generará un ID de sesión.
## ¿Cuándo usar cada tabla?
A continuación encontrarás sugerencias e ideas para sacar el máximo provecho de estas tablas fundamentales.
### **Cómo usar la tabla de Sesiones**
**Medir los puntos de abandono en un flujo**
* Filtra las sesiones por *Conversation ID* y *Conversation Version*, luego agrupa por *Last Node ID* para ver en qué nodos los usuarios abandonan con mayor frecuencia. Así detectarás puntos de fricción y podrás rediseñar nodos concretos o respuestas rápidas.
**Evaluar la atribución de campañas provenientes de anuncios de Meta**
* Concéntrate en las filas donde *Meta Source ID* no sea nulo. Agrupa por *Meta Source Type* y *Meta Source ID* para identificar qué anuncios o publicaciones generan más sesiones y cuánto duran. Añade ROAS relacionando el gasto publicitario en Meta.
**Calcular la duración media de las sesiones y la tendencia de engagement**
* Resta *Session Started Timestamp* de *Session Finished Timestamp* en cada fila y luego promedia por día o semana. Un aumento indica mayor engagement; una caída repentina puede señalar problemas de UX o fatiga de plantillas.
**Construir un embudo de retención de usuarios**
* Como cada visita posterior crea una nueva sesión, puedes unir sesiones por *User Cellphone* y medir las tasas de retorno día 1, día 7 o día 30. Así verás si los cambios en el diseño de la conversación fomentan el re-engagement.
**Identificar fuentes inbound de alto valor**
* Filtra las sesiones **Inbound** y agrupa por *WhatsApp Link Campaign Source* o por los campos de Meta que no sean nulos. Compara con eventos de conversión (almacenados en otra parte) para saber qué canales orgánicos o de pago aportan tráfico más cualificado.
### **Cómo usar la tabla de Despliegues**
**Supervisar la tasa de éxito de entrega**
* Divide el número de filas con *Deployment Status* **Delivered** entre el total del mismo periodo. Desglósalo por conversación, país o fecha de inicio del despliegue para detectar problemas de calidad o cumplimiento a tiempo.
**Diagnosticar patrones de fallas**
* Agrupa las filas con *Deployment Status = Failed* y organiza por *Failure Reason*. Esto ayuda a depurar la segmentación, el copy o las aprobaciones de plantillas.
**Atribuir sesiones a campañas outbound**
* Une Despliegues con Sesiones usando *Session ID* (solo donde el estado sea **Delivered**) para ver qué envíos realmente generan conversaciones y cuánto duran esas sesiones.
**Comparar rendimiento por países o segmentos**
* Agrupa por *User Country Code* o etiquetas de audiencia personalizadas que tengas y calcula tasa de entrega, clics (sesiones creadas) y métricas de conversión finales. Así optimizas la asignación de presupuesto en futuros envíos.
***
## **Preguntas frecuentes**
1. **¿Con qué frecuencia se actualizan los datos?**
Las tablas fundamentales se actualizan cada tres horas. Es decir, las nuevas sesiones o despliegues pueden tardar hasta tres horas en reflejarse en tus consultas.
2. **¿En qué zona horaria se almacenan las marcas de tiempo?**
Todas las marcas de tiempo se almacenan en UTC. Convierte a tu zona local en las herramientas de análisis posteriores si es necesario.
3. **¿Cuánto historial de datos está disponible?**
El Centro de Métricas conserva 30 días de datos en forma continua, por lo que no podrás consultar eventos anteriores a ese periodo.
4. **¿Qué inicia y qué finaliza exactamente una sesión?**
Una sesión empieza cuando un mensaje (inbound u outbound) dispara una conversación y termina cuando se redirige a otro flujo, se cierra por inactividad o un agente la cierra manualmente. Si el usuario vuelve después, se crea una nueva sesión.
5. **¿Cuándo se rellena el campo Parent Session ID?**
Solo cuando la sesión se crea mediante una **Redirección**. El campo contiene el ID de la sesión anterior y permite seguir el recorrido del usuario entre varios flujos. En los demás casos permanece vacío.
6. **¿Cómo relaciono Despliegues con Sesiones?**
Usa *Session ID* presente en la tabla de Despliegues (filas con *Deployment Status = Delivered*). Así vinculas un envío outbound con la sesión que generó.
7. **¿Por qué algunos campos de Meta aparecen vacíos?**
Las columnas de atribución de Meta (Meta Source URL, Meta Source Type, etc.) solo se rellenan cuando la sesión se inició mediante un anuncio **Click-to-WhatsApp**. Para mensajes inbound que provengan de otra fuente, estos campos quedarán nulos.
8. **¿Qué ocurre con los mensajes multimedia?**
Los campos *First Message* y *Last Message* solo almacenan texto. Si la primera o última interacción es imagen, audio, video o sticker, el campo de texto estará en blanco; usa las marcas de tiempo para saber cuándo ocurrió.
9. **¿Puedo calcular embudos o métricas de conversión solo con estas dos tablas?**
Sí. Utiliza la tabla de Sesiones para medir puntos de entrada y abandono dentro de los flujos y luego únela a Despliegues para atribuir esos comportamientos a campañas outbound concretas.
# Contactos
Source: https://help.treble.ai/es/docs/main-platform/contacts
Treble incluye un CRM liviano integrado que centraliza todos tus contactos de WhatsApp en un solo lugar. Aprende a gestionar contactos, propiedades personalizadas, listas y acciones masivas.
## ¿Qué es la sección de Contactos?
La sección de **Contactos** es el CRM liviano de Treble. Aquí se centralizan automáticamente todos los números de WhatsApp con los que tu empresa ha interactuado: cualquier usuario que reciba una conversación outbound o que inicie una conversación inbound queda registrado como contacto sin ninguna acción manual de tu parte.
Desde esta sección puedes:
* Ver y buscar todos tus contactos en un solo lugar.
* Crear **propiedades personalizadas** (texto, número o fecha) para enriquecer los perfiles.
* Organizar contactos en **listas** para segmentarlos.
* Aplicar **filtros** para encontrar exactamente el segmento que necesitas.
* Ejecutar **acciones masivas**: enviar conversaciones, agregar o remover de listas, o eliminar contactos.
En la parte superior de la sección encontrarás tres métricas clave:
* **Contactos totales**: el número total de contactos registrados en tu cuenta.
* **Contactos opt-out**: contactos que han solicitado no recibir más mensajes.
* **Nuevos Contactos (último mes)**: contactos creados en los últimos 30 días, útil para medir el crecimiento de tu base.
***
## Agregar un contacto
Puedes agregar contactos de dos formas: uno a uno o cargando un archivo CSV. Haz click en el botón **Agregar contacto** en la esquina superior derecha para acceder a ambas opciones.
### Agregar uno a uno
Completa el formulario con los datos del contacto:
* **Nombre Completo**: nombre del contacto.
* **Email**: correo electrónico.
* **Número de Teléfono**: selecciona el código de país e ingresa el número.
* **Propiedades adicionales**: cualquier propiedad personalizada que hayas creado aparecerá aquí como campo adicional (por ejemplo, CRM, saldo, Company URL, edad).
### Agregar por CSV
Si necesitas cargar múltiples contactos a la vez, usa la pestaña de **Lista de contactos** dentro del mismo modal y haz click en **Subir archivo**.
El archivo CSV debe contener las columnas requeridas. Las columnas obligatorias son `country_code` y `cellphone`. Las columnas opcionales incluyen `name`, `email`, y cualquier propiedad personalizada que hayas creado (por ejemplo, `saldo`, `Company URL`, `edad`, o el nombre de una lista como `Leads Mayo`).
Descarga el archivo de ejemplo desde el modal para asegurarte de que tu CSV tenga el formato correcto antes de subirlo.
Los nombres de las columnas del CSV deben coincidir exactamente con los nombres internos de tus propiedades personalizadas. Si no coinciden, el campo no se importará.
***
## Propiedades personalizadas
Las propiedades personalizadas te permiten almacenar información adicional en cada contacto más allá de los campos base (nombre, teléfono, email). Puedes crear propiedades de tres tipos: **Texto**, **Número** o **Fecha**.
Para crear una propiedad, haz click en el botón **Propiedades** en la barra de herramientas y luego en **Crear nueva propiedad**.
Asigna un nombre descriptivo a la propiedad y selecciona su tipo:
Los tipos disponibles son:
| Tipo | Descripción |
| ---------- | -------------------------------------------------------------------------------------------- |
| **Texto** | Almacena cualquier cadena de texto libre. Ideal para campos como empresa, categoría o notas. |
| **Número** | Almacena valores numéricos. Ideal para saldos, scores o cantidades. |
| **Fecha** | Almacena fechas. Ideal para fechas de última compra, renovación o vencimiento. |
Una vez creada, la propiedad aparece como columna en la tabla de contactos y como campo disponible al agregar o editar contactos, al cargar CSVs y al usar variables en el editor de conversaciones.
Para ver y gestionar todas tus propiedades, haz click en **Propiedades → Ver propiedades personalizadas**.
***
## Listas de contactos
Las listas te permiten segmentar tus contactos en grupos con nombre para poder filtrarlos y enviarles conversaciones de forma dirigida.
Para crear una lista, haz click en el botón **Listas** en la barra de herramientas, escribe el nombre de la nueva lista y haz click en **Crear lista**.
Las listas que crees aparecerán:
* Como columna en la tabla de contactos, mostrando a qué listas pertenece cada contacto.
* Como filtro disponible en el panel de **Filtros**.
* Como opción al ejecutar acciones masivas de **Agregar a lista** o **Eliminar de lista**.
***
## Barra de herramientas
La barra de herramientas, ubicada en la parte superior derecha de la tabla, contiene las siguientes acciones:
| Acción | Descripción |
| ------------------------------------------- | ----------------------------------------------------------------- |
| **Buscar** | Busca contactos por nombre o número de teléfono. |
| **Exportar** | Descarga la lista de contactos filtrados en formato CSV. |
| **Propiedades** | Crea nuevas propiedades personalizadas o consulta las existentes. |
| **Listas** | Crea nuevas listas de segmentación. |
| **Agregar contacto** | Abre el modal para agregar un contacto manualmente o por CSV. |
***
## Filtros
El panel de filtros te permite reducir la vista de contactos a exactamente el segmento que necesitas trabajar. Haz click en el botón **Filtros** para abrirlo.
Los filtros disponibles son:
| Filtro | Opciones |
| ------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
| **Rango de fechas** | Hoy, Ayer, Últimos 7 días, Últimas 2 semanas, Último mes, Últimos 3 meses, Último año. Filtra por fecha de creación del contacto. |
| **Estado** | Todos los contactos, Opt-Out, Opt-In. |
| **Listas** | Muestra solo los contactos que pertenecen a una o más listas seleccionadas. |
| **País** | Filtra por código de país del número de teléfono. |
Una vez configurados los filtros, haz click en **Aplicar filtros**. La tabla se actualizará y el encabezado mostrará un enlace **Seleccionar \[N] contactos filtrados** que te permite seleccionar todos los contactos que cumplen con los criterios, independientemente de la página.
***
## Acciones masivas
Con uno o más contactos seleccionados, aparece una barra en la parte inferior de la pantalla con las acciones masivas disponibles.
Puedes seleccionar contactos de tres formas:
* **Individualmente**: marca la casilla junto a cada contacto.
* **Página actual**: marca la casilla del encabezado para seleccionar todos los contactos de la página visible.
* **Todos los filtrados**: haz click en el enlace **Seleccionar \[N] contactos filtrados** en la barra superior para seleccionar todos los que pasen los filtros activos, incluso si son miles.
Las acciones disponibles son:
### 🗑 Eliminar
Elimina permanentemente los contactos seleccionados de tu cuenta.
### ➕ Agregar a lista
Agrega los contactos seleccionados a una lista existente. Al hacer click, aparece un buscador con tus listas disponibles. Selecciona la lista de destino y haz click en **Agregar**.
### — Eliminar de lista
Remueve los contactos seleccionados de una lista. Útil para limpiar segmentos sin eliminar los contactos de tu base.
### 📤 Enviar conversación
Despliega una conversación de Treble a los contactos seleccionados directamente desde la sección de Contactos. Al hacer click, se abre un buscador de conversaciones para que elijas cuál enviar.
#### Vincular propiedades
Si la conversación seleccionada contiene variables (por ejemplo, `{{name}}` o `{{company}}`), Treble verificará automáticamente si esas variables coinciden con las propiedades de tus contactos. Si hay variables que no coinciden, se mostrará el modal **Vincular propiedades**.
En este modal puedes mapear manualmente cada variable de la conversación con la propiedad del contacto que debe usarse como valor. Por ejemplo, la variable `name` de la conversación puede mapearse a la propiedad `name` del contacto.
Las propiedades disponibles para vincular incluyen los campos base del contacto (Email, WhatsApp Id, name, etc.) y todas las propiedades personalizadas que hayas creado.
Si la variable de tu conversación tiene exactamente el mismo nombre que la propiedad del contacto, Treble la vinculará automáticamente sin necesidad de hacerlo manualmente.
Si una propiedad que necesitas vincular no aparece en el listado, usa el enlace **No encuentro la propiedad que necesito** para crearla antes de continuar.
***
## Variables de Contactos en el editor de conversaciones
Las propiedades de tus contactos en Treble pueden usarse como variables directamente dentro del editor de conversaciones, de la misma forma en que se usan las
.
Esto significa que puedes:
* **Leer** una propiedad del contacto dentro de un mensaje. Por ejemplo, saludar al cliente por su nombre usando la propiedad `name`.
* **Escribir** la respuesta del cliente en una propiedad del contacto. Por ejemplo, capturar el correo que proporcione y guardarlo en su propiedad `email`.
Las variables de Contactos tienen un formato especial según el tipo de propiedad:
* **Propiedades predeterminadas** (nombre y correo): usan el prefijo `trbcontact_d_`.
* **Propiedades personalizadas**: usan el prefijo `trbcontact_c_` seguido del nombre interno de la propiedad.
| Propiedad | Variable |
| ---------------------------- | ------------------------------- |
| Nombre (predeterminado) | `{{trbcontact_d_name}}` |
| Correo (predeterminado) | `{{trbcontact_d_email}}` |
| Source (personalizada) | `{{trbcontact_c_source}}` |
| Edad (personalizada) | `{{trbcontact_c_edad}}` |
| Departamento (personalizada) | `{{trbcontact_c_departamento}}` |
| Sitio web (personalizada) | `{{trbcontact_c_sitio_web}}` |
El nombre interno de una propiedad personalizada es el que asignaste al crearla. Si no recuerdas el nombre exacto, consúltalo en **Propiedades → Ver propiedades personalizadas**.
Al igual que con las variables de HubSpot, para guardar la respuesta de un cliente en una propiedad del contacto debes hacer doble click en el bloque correspondiente en el editor, seleccionar **Guardar respuesta como variable** y escribir el nombre de la variable del contacto (por ejemplo, `trbcontact_c_edad`) en el campo de nombre de la variable.
# Editor de Flujos de Conversación
Source: https://help.treble.ai/es/docs/main-platform/conversation-editor
En el editor de flujos de conversaciones podrás diseñar, configurar y conectar bloques de mensajes para crear el flujo automatizado de tu conversación en Treble.
# Vista general del Editor
El **Editor de conversaciones** es la herramienta central para construir flujos de atención automatizados en Treble para WhatsApp. Funciona como un **árbol de decisión**, donde cada **bloque** representa un paso del diálogo y se conecta con otros para guiar la conversación según las respuestas del usuario.
Al entrar al editor, verás una pantalla dividida en dos áreas principales:
* **Panel izquierdo:** Catálogo de tipos de bloque disponibles para agregar al flujo.
* **Lienzo derecho:** Espacio donde construirás y conectarás los bloques para dar forma al recorrido conversacional.
## Panel de tipos de bloque
En el lado izquierdo de la pantalla se encuentra el **selector de tipo de bloque**. Aquí puedes elegir entre **bloques básicos** y **bloques avanzados** para agregar al flujo. Para agregar un bloque, haz click en el botón y selecciona el tipo de bloque que deseas agregar.
### Bloques básicos
Son bloques fundamentales para estructurar la conversación:
* **Mensaje plantilla (HSM):** Envía mensajes preaprobados por Meta, útiles para notificaciones o seguimientos oficiales.
* **Mensaje con opciones:** Permite al usuario elegir entre diferentes respuestas predefinidas para dirigir el flujo.
* **Mensaje simple:** Envía un texto donde el usuario puede responder libremente. Permite recolectar datos abiertos.
* **Transferencia a humano:** Conecta al usuario con un representante humano de tu equipo.
* **WhatsApp Flows (nuevo):** Crea formularios interactivos nativos en WhatsApp, sin salir del chat.
### Bloques avanzados
Diseñados para lógica más compleja y personalización de flujos:
* **Condiciones:** Define caminos condicionales según datos del usuario o respuestas anteriores.
* **Enlace a conversación:** Permite saltar a otras conversaciones ya existentes en tu cuenta.
* **Pruebas A/B:** Divide el flujo entre variantes para comparar resultados y optimizar mensajes.
* **Asistente IA (beta):** Integra un módulo que responde a preguntas del cliente con inteligencia artificial.
## Subpanel de lista interactiva
Al seleccionar el bloque **Mensaje con opciones**, aparece un subpanel (a la derecha del selector) que ofrece variaciones de interacción:
* **Botones interactivos:** Permite enviar hasta 3 botones de respuesta rápida.
* **Lista interactiva:** Presenta hasta 10 opciones en un formato de lista desplegable.
* **Mensaje con opciones:** Define respuestas predefinidas para elegir de forma sencilla.
Cada variante se adapta a distintas necesidades de conversación y estilos de interacción con el cliente.
## Lienzo de edición
El espacio central y derecho de la pantalla es el **lienzo**. Aquí puedes:
* Arrastrar y soltar los bloques desde el panel izquierdo.
* Conectar bloques entre sí para definir el flujo de la conversación.
* Configurar el contenido de cada bloque (texto, opciones, lógica condicional).
* Organizar visualmente el flujo como un árbol de decisión para entender y validar el recorrido del usuario.
## Barra superior del editor
En la parte superior encontrarás controles clave:
* **Nombre del flujo:** Editable para identificar fácilmente tu conversación (en la imagen, “Conversation Name”).
* **Estado de publicación:** Indica si la versión está publicada o en edición (ejemplo: “Ninguna versión publicada”).
* **Botón de creación o publicación:** Para guardar y habilitar la conversación para uso en WhatsApp Business.
* **Botones de deshacer y rehacer:** Permiten revertir o repetir cambios recientes.
* **Icono de engranaje:** Accede a configuraciones generales del flujo o proyecto.
* **Botón de salida:** Para volver al listado general de conversaciones.
### Sección de configuración
En la sección de configuración, podrás encontrar las siguientes opciones:
* **Nombre del flujo:** Editable para identificar fácilmente tu conversación (en la imagen, “Conversation Name”).
* **Idioma:** Selecciona el idioma de tu conversación, esto es importante para que el flujo se comporte de manera correcta en el idioma seleccionado y que los mensajes predeterminados, por ejemplo, cuando el flujo no entiende la respuesta del usuario, se traduzca al idioma seleccionado.
* **Huso Horario:** Permite seleccionar el huso horario de tu conversación, esto es importante para que el flujo se comporte de manera correcta en el huso horario seleccionado.
Aprende a configurar horarios y condiciones de tiempo.
### Sección de integraciones ligeras (Google Sheets)
En la sección de integraciones ligeras, que podrás encontrar al hacer click en el botón de , podrás encontrar la opción de configurar la integración con Google Sheets. Al hacer click en la opción de **Google Sheets**, se desplegará un panel de configuración donde podrás configurar la integración con Google Sheets.
En el panel de configuración, podrás encontrar las siguientes opciones:
* **URL de google sheets:** Permite seleccionar la URL de tu hoja de Google Sheets que deseas usar para la integración.
* **Variable mensaje inbound:** Permite seleccionar la variable de mensaje inbound que deseas usar para la integración.
## Zoom y navegación del lienzo
En la parte inferior central del editor verás el **control de zoom**:
* Ajusta el nivel de zoom del lienzo para ver flujos grandes o trabajar en detalle.
* Incluye un control deslizante y botones para acercar, alejar o ajustar la vista.
***
## ¿Cómo diseñar una conversación en el editor?
Para crear un flujo:
1. Selecciona el **tipo de bloque** en el panel izquierdo.
2. Configura su contenido (mensaje, opciones, condiciones).
3. Arrástralo al lienzo y conéctalo con otros bloques.
4. Define las ramificaciones según las respuestas del usuario.
5. Guarda y publica cuando estés satisfecho con el diseño.
El editor está pensado para **empresas de cualquier tamaño**, permitiéndoles automatizar conversaciones en WhatsApp de forma **visual, flexible y sin necesidad de programar**.
# Métricas de conversación
Source: https://help.treble.ai/es/docs/main-platform/conversation-metrics
Aprende a entender los resultados de tus conversaciones por medio de la sección de métricas de conversación.
## Métricas de conversación
Una vez hayas creado una conversación, sea inbound o outbound, seguramente querrás saber cómo está funcionando. Para esto, Treble te ofrece una serie de métricas que te permitirán entender los resultados de tus conversaciones. Para acceder a las métricas de una conversación, puedes hacerlo de dos maneras:
1. **Acceder desde la vista de todas tus conversaciones**: En la vista de todas tus conversaciones, puedes hacer click en el botón **Métricas** para acceder a las métricas de la conversación.
2. **Acceder desde el editor de conversación**: En el editor de una conversación, puedes hacer click en el botón **Métricas** para acceder a las métricas de la conversación.
3. **Después de hacer un envío de conversación**: Después de hacer un envío de conversación, puedes hacer click en el botón **Ver resultados** para acceder a las métricas de la conversación.
Entendamos cada una de las métricas que puedes ver en la sección de métricas de conversación.
## Sección de Resumen
La sección de resumen te permite ver un resumen de las métricas de la conversación. Puedes ver el número de conversaciones enviadas, el número de conversaciones recibidas, el número de conversaciones fallidas y el número de conversaciones exitosas. Entendamos cada una de estas métricas.
### Total de Usuarios
Muestra el número total de usuarios que se les ha intentado hacer un despliegue de la conversación para la versión actual de la conversación. Mas adelante, te explicaremos versiones de conversación.
### Mensajes enviados
Muestra el número total de conversaciones que fueron enviadas con éxito a los usuarios.
### En proceso
Muestra el número total de conversaciones que se están procesando. ¿Por qué puede estar en proceso? Una conversación puede estar en proceso por varias razones:
* La conversación no se ha enviado aún y Treble sigue intentando enviar la conversación.
* Treble ha comunicado a WhatsApp por medio de la API que se realice un envío de la conversación, pero WhatsApp aún no ha realizado el envío.
* El usuario tiene su celular apagado o sin conexión a internet y WhatsApp no le ha podido enviar la conversación.
Treble intenta procesar los despliegues de una conversación de la forma mas eficiente y rapida posible. Sin embargo, si haces un envío de una conversación a un gran número de usuarios, Treble puede tardar unos minutos en procesar el envío de la conversación, por lo cual es normal que veas esta métrica en proceso.
Si consideras que una conversación se ha tardado demasiado en procesarse, por favor no dudes en contactarnos a través de nuestro chat de soporte.
### Fallo en el envío
Muestra el número total de conversaciones que han fallado en ser enviadas a los usuarios. ¿Por qué puede fallar? Una conversación puede fallar por varias razones:
* El usuario no tiene WhatsApp instalado.
* El usuario ha bloqueado la linea de WhatsApp por la cual se intenta enviar la conversación.
* El número de celular del usuario no es válido.
* El usuario tiene una conversación abierta con agentes y este tipo de conversaciones tienen prioridad sobre nuevos envíos.
Estas son algunas de las razones mas comunes por las cuales una conversación puede fallar. Sin embargo, abajo puedes encontrar más información sobre todas las posibles razones por las cuales una conversación puede fallar.
#### Estados de despliegue
La conversación ha sido enviada con éxito a los usuarios.
La conversación se está procesando.
La conversación no se envió dado que el usuario tiene una sesión activa con un agente. Treble le da prioridad a las conversaciones con agentes sobre las conversaciones de despliegue. Hasta que el asesor termine la conversación con el usuario, la conversación no se podrá volver a enviar para ese usuario.
La conversación no se envió dado que el usuario tiene WhatsApp bloqueado. Otras razones por las cuales una conversación puede fallar por bloqueo o versión son:
* El usuario no ha aceptado los nuevos términos de servicio y política de privacidad
* El usuario está usando una versión desactualizada de WhatsApp
* El usuario no tiene una cuenta de WhatsApp
La conversación no se envió dado que el usuario fue bloqueado previamente por la empresa a través de la opción de exclusión. Esta es una "lista negra" configurable dentro de Treble para evitar que ciertos usuarios sean contactados.
La conversación no se envió dado que el número de WhatsApp del usuario no es válido.
Cuando el HSM contiene variables y no se logra llenar su valor, el envió fallará. Puede generarse por:
* La variable está mal escrita.
* El usuario no tienen un valor dentro de la propiedad.
* La variable no existe en la integración conectada con Treble. (HubSpot / Salesforce / etc.)
Una plantilla (HSM) de la API de WhatsApp Business puede ser pausada porque el mensaje de la plantilla asociado ha sido marcado como de baja calidad por WhatsApp, probablemente debido a la violación de sus directrices de mensajería, contener información irrelevante o ser percibido como spam por los usuarios; esta pausa impide el envío posterior de esa plantilla hasta que sea revisada y potencialmente editada para mejorar su calidad.
Puntos clave sobre la pausa de HSM:
* Calificación de Baja Calidad:
WhatsApp evalúa la calidad de tus plantillas HSM basándose en los comentarios de los usuarios y puede pausar una plantilla si recibe demasiadas reacciones negativas.
* Sistema de Notificaciones:
Cuando una plantilla es pausada, recibirás notificaciones a través del Administrador de Negocios de WhatsApp, alertas por correo electrónico y webhooks.
* Revisión y Edición:
Para reanudar el envío de mensajes, necesitas revisar la plantilla pausada, identificar los problemas que causan la calificación de baja calidad y editar el contenido en consecuencia.
* Consecuencias Potenciales:
Las plantillas pausadas repetidamente podrían ser deshabilitadas permanentemente.
Qué hacer si tu HSM es pausado:
* Revisar notificaciones:
Revisa las alertas de WhatsApp para entender la razón de la pausa.
* Analizar tu plantilla:
Identifica áreas donde el mensaje podría mejorarse en claridad y relevancia.
* Editar y reenviar:
Modifica el contenido de la plantilla para abordar los problemas y vuelve a enviarla para revisión.
* Consultar las directrices de WhatsApp:
Familiarízate con las políticas de mensajería de WhatsApp para evitar problemas futuros.
Este nuevo error pasa cuando se envía 2 o más plantillas (HSM) en un periodo corto de tiempo al mismo contacto sin respuesta, el contacto se queda bloqueado para recibir nuevos plantillas (HSM) por un periodo, y cuanto más plantillas (HSM) enviados con ese error, mayor es el tiempo de bloqueo. La recomendación es desplegar 1 plantilla (HSM) y esperar 24 horas antes de enviar una segunda o tercera plantilla (HSM).
La conversación no se envió por una falla general del sistema. En estos casos, por favor contacta a soporte.
### Entregado
Muestra el número total de conversaciones que han sido enviadas con éxito a los usuarios.
### Respuestas
Muestra el número total de respuestas que han sido recibidas de los usuarios al primer mensaje de la conversación. En el caso de una conversación outbound, esta métrica te permitirá entender cuántos usuarios han respondido a la plantilla (HSM) de la conversación.
### Tasa de respuesta
Muestra el porcentaje de respuestas que han sido recibidas de los usuarios al primer mensaje de la conversación. En el caso de una conversación outbound, esta métrica te permitirá entender cuántos usuarios han respondido a la plantilla (HSM) de la conversación.
Es decir, la tasa de respuesta es calculada como:
```
Tasa de respuesta = (Respuestas al primer mensaje / Total de usuarios enviados exitosamente) * 100
```
## Sección de usuarios individuales
En esta sección, puedes ver información de cada usuario individual al cual se le ha intentado hacer un despliegue de la conversación. Vas a encontrar información como:
* **Celular**: El número de WhatsApp del usuario.
* **Fecha del despliegue**: Fecha en minutos desde que se envió la conversación.
* **Estado del despliegue**: Estado del despliegue de la conversación. Estos son los estados de despliegue mencionados anteriormente.
* **Etapa de la conversación**: Si el usuario respondió a la conversación, pero no la ha finalizado, se mostrará la etapa "En el flujo". Si el usuario finalizó la conversación, se mostrará la etapa "Finalizada".
* **Última actividad**: Fecha en minutos desde que el usuario realizó alguna acción en la conversación.
* **Variables**: Variables que se han llenado en la conversación. Si tu conversación manejó variables a la hora de ser enviada, o si tu conversación tiene variables para capturar respuestas en el flujo, se mostrarán las variables que se han llenado. Has scroll hacia la derecha para ver las variables.
### Historial de conversación de un usuario
En la sección de usuarios individuales, puedes hacer click en el número de celular del usuario para ver el historial de la conversación de ese usuario.
Finalmente, vas a encontrar filtros para poder filtrar los usuarios que quieres ver en la sección de usuarios individuales. Estos son los filtros que puedes usar:
* **Estado del despliegue**: Filtra los usuarios por estado de despliegue.
* **Etapa de la conversación**: Filtra los usuarios por etapa de la conversación.
* **Estado de la sesión**: Filtra los usuarios por estado de la sesión.
# Base de conocimiento
Source: https://help.treble.ai/es/docs/main-platform/knowledge-base
## Introducción
Una base de conocimiento bien estructurada es esencial para que tus Agentes de IA entreguen respuestas útiles, precisas y coherentes. Si los documentos que subes están mal estructurados, incompletos o son difíciles de interpretar, el Agente de IA puede ofrecer respuestas incorrectas o inventadas. Por otro lado, cuando la información es clara, organizada y redactada con intención, el Agente de IA entiende mejor el contexto y entrega respuestas de mayor calidad. Crear una base de conocimiento sólida es como capacitar a un nuevo miembro del equipo: necesitas explicar las cosas con claridad, proporcionar documentos bien elaborados y asegurarte de que los comprenda.
***
## Usa formatos legibles por la IA
La IA solo puede leer texto digital. Los archivos escaneados o los que contienen texto como imagen no son útiles, aunque visualmente se vean bien.
**Recomendado**: `.docx`, `.txt`, `.md`, `.pdf` (solo si el texto es seleccionable)
### Ejemplos
✅ **Correcto**: Un documento `.docx` exportado desde Word con estilos de encabezado, párrafos y listas.
✅ **Correcto**: Un archivo `.txt` simple con secciones separadas por títulos.
⚠️ **Aceptable**: Un `.pdf` generado desde Word u otra herramienta digital, siempre que puedas seleccionar el texto con el mouse.
❌ **Incorrecto**: Un PDF escaneado desde papel o un archivo basado en imágenes (aunque se vea profesional, la IA no podrá interpretarlo).
¿Cómo saber si tu archivo es válido? Abre el PDF e intenta seleccionar y copiar el texto. Si no puedes, no funcionará con la IA. No uses capturas de pantalla ni fotos de documentos como archivos fuente.
***
## Estructura clara y por temas
Una base de conocimiento efectiva está organizada por temas. No pongas todo en un solo documento largo y ambiguo. Usa títulos, subtítulos y segmenta el contenido según su propósito. **Haz esto:**
* Divide tu contenido en archivos separados por tema o departamento (ej.: "Políticas de facturación", "Preguntas frecuentes sobre envíos", "Ficha técnica del Producto A").
* Usa encabezados jerárquicos (`Título principal`, `Subtítulo`, `Puntos clave`).
### Ejemplos
✅ **Correcto**: Un documento sobre garantías con secciones como "¿Qué cubre?", "Duración", "Cómo presentar una reclamación".
❌ **Incorrecto**: Un archivo que mezcla políticas de ventas, información de contacto, especificaciones del producto y soporte en una sola página continua.
Agrega una tabla de contenido al inicio si el documento tiene más de 3 secciones. Esto ayuda a los Agentes de IA a navegar el contenido rápidamente.
***
## Escribe con contexto completo
Cada fragmento de texto debe tener sentido por sí solo. **La IA a menudo lee solo un párrafo aislado, por lo que no debe depender de títulos ni del contenido anterior.** **Haz esto:**
* Escribe con contexto explícito.
* Incluye nombres de productos, lugares, fechas o condiciones directamente en la oración.
### Ejemplos
✅ **Correcto**: "La política de garantía para autos eléctricos es válida en México y tiene una duración de 24 meses a partir de la fecha de compra."
❌ **Incorrecto**: "Tiene 2 años de cobertura" (¿Qué tiene? ¿Dónde? ¿Desde cuándo?)
***
## Usa lenguaje claro, preciso y consistente
La IA no interpreta la ambigüedad, la jerga o las frases enredadas como lo haría un humano. Es fundamental escribir con claridad, evitar sinónimos innecesarios y definir todos los términos. **Haz esto:**
Usa oraciones cortas y directas.
Mantén el mismo término para cada concepto (ej.: no alternes entre "cliente" y "usuario").
Define los acrónimos la primera vez que los uses.
### Ejemplos
✅ **Correcto**: "El CRM (Customer Relationship Management) ayuda a gestionar todos los prospectos."
❌ **Incorrecto**: "La herramienta de leads o sistema de usuarios permite..." (confuso e inconsistente)
Haz una búsqueda rápida en tu documento para asegurarte de usar los mismos términos clave de forma consistente. Esto minimiza los errores semánticos en las respuestas del Agente de IA.
***
## Usa plantillas y formatos repetibles
Cuando subas muchos documentos similares (como fichas de productos, procesos o guías), usar una estructura consistente ayuda al modelo a reconocer patrones.
**Haz esto:**
* Usa plantillas fijas para cada tipo de documento.
* Mantén el mismo orden de secciones en cada archivo.
### Ejemplos
✅ **Correcto**: Cada producto incluye: nombre, descripción, especificaciones, preguntas frecuentes, contacto de soporte.
❌ **Incorrecto**: Cada ficha de producto tiene un diseño diferente: a algunas les falta la descripción o la separación por secciones.
Crea una plantilla base que puedas duplicar para cada nuevo documento. Esto garantiza consistencia sin esfuerzo y acelera tu proceso de documentación.
***
## Incluye preguntas y ejemplos
Anticipar las preguntas del usuario ayuda al modelo a entender mejor el lenguaje natural. Incluir ejemplos de preguntas y respuestas bien redactados mejora significativamente la calidad de las respuestas generadas. **Haz esto:**
* Incluye una pequeña sección de preguntas frecuentes (FAQ).
* Escribe preguntas reales o representativas con respuestas claras.
### Ejemplos
✅ **Correcto**:
**P:** ¿Hacen envíos internacionales? **R:** Actualmente solo enviamos dentro de México. Próximamente se agregarán más países.
❌ **Incorrecto**: Solo incluir "no hacemos envíos internacionales" fuera de contexto o en una lista con viñetas.
***
## Elimina redundancias y contradicciones
Dos archivos con versiones diferentes del mismo dato pueden confundir a la IA y generar respuestas incorrectas. La IA no "elige la mejor", sino que mezcla lo que encuentra.
**Haz esto:**
* Centraliza los datos clave (precios, fechas, condiciones).
* Conserva solo la versión más reciente de cada documento.
### Ejemplos
✅ **Correcto**: Un único archivo titulado "Políticas de garantía actualizadas - marzo 2025.pdf"
❌ **Incorrecto**: Tres archivos diferentes que indican que la garantía es de 6, 12 y 24 meses respectivamente.
***
## Mantén tu base de conocimiento actualizada
La calidad de tu agente también depende de qué tan vigente esté tu información. Los documentos siempre deben ser relevantes y estar al día. **Haz esto:**
* Revisa tu base de conocimiento mensual o trimestralmente.
* Revísala cada vez que haya cambios en tus productos o servicios.
* Elimina archivos desactualizados y sube versiones actualizadas con fechas claras.
### Ejemplos
✅ **Correcto**: "Catálogo de productos - actualizado abril 2025"
❌ **Incorrecto**: Documentos mezclados sin claridad sobre cuál está vigente.
***
## Qué incluir según la industria
Cada industria tiene información clave que siempre debe estar presente en sus documentos. Asegúrate de incluir estos detalles para que tus agentes tengan el contexto completo:
| Industria | Información clave a incluir |
| ------------ | ---------------------------------------------------------- |
| Educación | Fechas de inscripción, niveles académicos, modalidades |
| Salud | Procedimientos, horarios, tipo de servicios |
| Inmobiliaria | Ubicación, precios, medios de contacto |
| Facturación | Métodos de pago, vigencia de facturas, contacto de soporte |
| Automotriz | Modelos disponibles, garantías, ubicación de agencias |
| Joyería | Tipos de producto, materiales, políticas de devolución |
**Ejemplo**: En la industria de la salud, un documento que solo dice "disponible en la mañana" no es suficiente. Es mejor escribir: "El Dr. Ramírez atiende en la Clínica del Sur de lunes a viernes, de 8:00 a.m. a 2:00 p.m."
# Acortador de links de Treble
Source: https://help.treble.ai/es/docs/main-platform/link-shortener
Treble cuenta de forma nativa con un acortador de links, pensado para facilitar la forma en que compartes URLs con tus clientes.
Treble cuenta de forma nativa con un acortador de links, pensado para facilitar
la forma en que compartes URLs con tus clientes.
El acortador de links te permite pegar la URL de tu página web, producto, servicio o cualquier dirección que desees enviar. Con solo un clic, en cuestión de segundos obtendrás un link más corto, limpio y fácil de compartir, ideal para conversaciones por chat.
Los links acortados tienen el siguiente formato: [https://trb.ai/CODIGO](https://trb.ai/CODIGO) donde
CODIGO es un código único de 6 caracteres de longitud generados
aleatoriamente.
En las próximas semanas, esta herramienta incorporará métricas de uso, donde podrás ver cuántos usuarios han visitado cada URL acortada que envíes, ayudándote a medir el impacto de tus mensajes.
Por ahora, el acortador de links está disponible exclusivamente dentro del nodo de mensaje simple en el creador de conversaciones. Nuestro equipo ya está trabajando para extender esta funcionalidad a otras áreas de la plataforma, incluyendo la aplicación de Sales y el creador de HSMs, muy pronto.
# Enviar Conversación Outbound
Source: https://help.treble.ai/es/docs/main-platform/send-convo
Aprende cómo enviar tus conversaciones outbound a tus clientes y las diferentes formas de hacerlo.
## Sección de envío de conversaciones
Una vez que hayas creado una conversación outbound, puedes enviarla a tus clientes accediendo a la sección de envío de conversaciones. Para hacer esto, tienes dos opciones:
1. **Crear y enviar conversación**: Cuando estés creando una conversación, puedes seleccionar el botón **Crear Conversación** y luego en **Enviar la conversación ahora (Outbound)**. Esto te llevará a la sección de envío de conversaciones.
2. **Enviar conversación desde la vista de todas tus conversaciones**: En la vista de todas tus conversaciones, puedes hacer click en el botón **Enviar** para enviar la conversación, esto te llevará a la sección de envío de conversaciones.
## Formas de enviar conversaciones outbound
Existen cuatro formas de enviar conversaciones outbound a tus clientes:
1. **Agregar usuarios manualmente**: Esta es la forma más sencilla de enviar una conversación a uno o varios números de teléfono. Esto es ideal cuando quieres probar la conversación o la quieres enviar a un grupo pequeño de clientes.
2. **Enviar conversación subiendo archivo CSV**: Puedes subir un archivo CSV con los números de teléfono a los que deseas enviar la conversación. Esto es ideal cuando quieres enviar la conversación a un grupo grande de clientes.
3. **Enviar por medio de API**: Puedes enviar la conversación por medio de nuestra API. Esto es ideal cuando quieres automatizar el envío de la conversación a tus clientes.
4. **Enviar conversación por medio de una integración**: Puedes enviar la conversación por medio de una integración. Si eres usuario de HubSpot o Salesforce y tienes una integración con Treble, puedes enviar la conversación a tus clientes desde tu CRM.
## Enviar conversación agregando usuarios manualmente
En la vista de envío de conversaciones, agrega los números de teléfono a los que deseas enviar la conversación. Si tu conversación tiene variables (información dinámica para personalizar el mensaje), puedes agregar los valores de las variables en sus relativos campos.
Una vez hayas agregado los usuarios que van a recibir la conversación, puedes hacer click en el botón **Enviar** para enviar la conversación.
## Enviar conversación subiendo archivo CSV
Para subir un archivo CSV con los números de teléfono a los que deseas enviar la conversación, haz click en el tab **Subir archivo**. Una vez hayas hecho click, encontrarás dos links útiles a en el panel de la izquierda:
* **Descargar ejemplo**: Este link te permitirá descargar un ejemplo de archivo CSV con los números de teléfono a los que deseas enviar la conversación.
* **Descargar CSV \[nombre tu de conversación]**: Este link te permitirá descargar una plantilla de archivo CSV la estructura de variables de tu conversación.
### Formato de archivo CSV
La estructura de las columnas de tu archivo CSV es muy importante para asegurar que la conversación se envíe correctamente. La estructura de las columnas es la siguiente:
| country\_code | cellphone | name |
| ------------- | ---------- | ------ |
| 57 | 3132392346 | Felipe |
| 34 | 622902416 | Camila |
En este ejemplo, **las columnas `country_code` y `cellphone` son obligatorias.** La columna `name` es un ejemplo de una variable que puedes usar en tu conversación.
Te recomendamos siempre que descargues la plantilla que ya tiene la estructura de variables de tu conversación. Esto te evitará errores al subir el archivo CSV.
Una vez tengas tu archivo CSV listo, puedes hacer click en el botón **Seleccionar archivo** para subir tu archivo CSV.
## Enviar Conversación
Una vez hayas agregado los usuarios que van a recibir la conversación, puedes escoger uno de los siguientes métodos de envío para enviar la conversación:
* **Enviar ahora**: Esta opción te permitirá enviar la conversación inmediatamente.
* **Enviar en mejor hora de respuesta por contacto y por país**: Esta opción te permitirá enviar la conversación en la mejor hora de respuesta por contacto y por país.
Selecciona el método de envío y haz click en el botón **Enviar conversación**.
¡Perfecto! La conversación se ha enviado correctamente.
## Próximos pasos
¿Quieres automatizar el envío de tus conversaciones por medio de una API? Consulta nuestra documentación de API para más información.
¿Quieres enviar tus conversaciones por medio de una integración? Consulta nuestra documentación de integración para más información.
# Sección de Configuración
Source: https://help.treble.ai/es/docs/main-platform/settings
La sección de Configuración es el lugar donde puedes configurar tu cuenta de Treble, tus preferencias y algunas configuraciones generales de tus flujos de conversación. Aprende a usar la sección de Configuración para personalizar tu cuenta y tus flujos de conversación.
## General
La **sección de Configuración General** te permite establecer la información esencial de tu cuenta en Treble.ai. Estos datos son utilizados en distintas funcionalidades de la plataforma, garantizando una experiencia más personalizada y consistente.
### Configuración del perfil
En esta sección defines el **nombre de tu compañía**, el cual se usa en todos los módulos de la plataforma que lo requieran.
#### Campo: Nombre de tu compañía
* **Input de texto** donde puedes ingresar o editar el nombre de tu empresa.
* Este nombre aparecerá en distintas funcionalidades de Treble.ai como:
* Plantillas personalizadas
* Etiquetas de mensajes
* Links de trackeo
#### Link de trackeo
Debajo del campo de nombre se muestra un **link de trackeo único** generado para tu cuenta. Es el link base para crear URLs con parámetros de seguimiento (UTM, campañas, etc.) que permitan medir interacciones y conversiones.
### Países de tus usuarios
Aquí seleccionas **uno o más códigos de país** donde se encuentran tus clientes. Treble.ai asignará automáticamente el **código de país correcto** a los números de teléfono que se capturen en tus formularios, links o integraciones. Esto es ideal para equipos que venden o atienden en varios países.
Si estás empezando a usar Treble.ai, recomendamos siempre seleccionar el país de tu empresa, especialmente que selecciones múltiples paises si tu empresa tiene presencia en varios países.
## Conversaciones
La sección **Conversaciones** dentro de **Configuración** te permite **administrar y personalizar** cómo se comportan las conversaciones con tus clientes y los **mensajes automáticos** que se envían en diferentes escenarios.
### Desactivar conversación si no hay respuesta del usuario
** Interruptor activable**: Cuando está activado, la plataforma cierra automáticamente conversaciones en espera si el cliente no responde en un tiempo determinado.
Recomendamos activar este interruptor en especial para que se sincronicen los datos de tus conversaciones con tu CRM. Normalmente, Treble genera una actividad dentro de tu CRM cuando se transfiere una conversación a un asesor humano y éste la cierra pero no genera una actividad cuando se cierra la conversación por inactividad. Al activar este interruptor, Treble generará una actividad en tu CRM cuando se cierra la conversación por inactividad.
### Desactivar después de tiempo de inactividad
Si configuras un tiempo de inactividad, la conversación se cerrará automáticamente si el usuario no responde en el tiempo configurado.
La configuración de tiempo de inactividad se aplica a todas las conversaciones y la unidad de tiempo es en minutos.
### Redirigir a un vendedor después de X fallas
Configura cuántos intentos fallidos tendrá un usuario para responder en un bloque de mensaje antes de transferirlo automáticamente a un agente humano. Esto es muy útil para evitar que un usuario se quede en un bloque de mensaje cuando responde con un mensaje que no coincide con ninguna de las opciones del bloque de mensaje.
Para configurar el número de intentos fallidos, has click en el botón **Configuración personalizada**. Selecciona del dropdown la cantidad de intentos fallidos. Estos van desde 2 hasta 5 intentos. Luego, selecciona el equipo de vendedores al cual se transferirá la conversación.
Conoce más sobre cómo transferir conversaciones a un asesor humano y la configuración de equipos de vendedores.
***
### Mensajes automáticos
En la parte inferior de la vista puedes personalizar los **mensajes automáticos** que la plataforma envía en varios escenarios. Cada tipo de mensaje puede configurarse en diferentes **idiomas**:
* Español
* Inglés
* Portugués
* Francés
* Italiano
Para cada tipo de mensaje hay un botón **“Configuración personalizada”** para definir su contenido.
### Tipos de mensajes automáticos disponibles
#### 1️⃣ Vendedores no disponibles
* Mensaje enviado cuando **ningún vendedor está conectado** para recibir la conversación.
* Ejemplo de uso: “En este momento no hay agentes disponibles, por favor deja tu consulta.”
#### 2️⃣ Transferencia a vendedor
* Mensaje que se envía **cuando la conversación se transfiere** desde el bot a un vendedor humano.
* Ejemplo: “Un agente te atenderá en breve.”
#### 3️⃣ Encuesta de satisfacción
* Mensaje enviado **cuando una conversación es cerrada** tras la atención de un vendedor.
* Se espera que el usuario califique el servicio, normalmente con un número del 1 al 5.
* Ejemplo: “Por favor califica tu experiencia con nuestro servicio del 1 al 5.”
#### 4️⃣ Mensaje no clasificado
* Se envía cuando la **respuesta del usuario no coincide** con ninguna de las opciones configuradas en un bloque de pregunta cerrada.
* Ejemplo: “Lo siento, no entendí tu respuesta. Por favor elige una de las opciones.”
#### 5️⃣ Ubicación no identificada
* Mensaje enviado cuando el usuario comparte **una dirección o ubicación** que el sistema no puede reconocer o procesar.
* Ejemplo: “No pudimos identificar tu ubicación, por favor revísala e intenta de nuevo.”
## Mi Equipo
La sección **Mi equipo** te permite **gestionar a las personas** que tienen acceso a tu cuenta de Treble.ai. Desde aquí puedes:
* Ver la lista de usuarios activos.
* Enviar nuevas invitaciones.
* Asignar o cambiar roles y permisos.
* Revocar accesos cuando sea necesario.
### Usuarios activos
Muestra a todos los usuarios que actualmente tienen acceso a tu cuenta. Aquí podrás:
* Ver su **nombre** y **correo electrónico**.
* Consultar o cambiar su **rol** (Usuario o Administrador).
* Usar el **buscador** para filtrar por nombre o email.
* Enviar nuevas invitaciones con el botón **“Enviar invitación”**.
#### Roles disponibles
* **Usuario:** Acceso limitado a ciertas funcionalidades.
* **Administrador:** Acceso completo para crear, editar y gestionar todos los recursos de la cuenta.
### Invitaciones
* Permite ver y gestionar las invitaciones enviadas a usuarios que aún no han aceptado.
* Puedes reenviar o cancelar invitaciones pendientes.
# Entendiendo la plataforma principal
Source: https://help.treble.ai/es/docs/main-platform/welcome
La plataforma principal de Treble es la plataforma que te permite crear y gestionar tus conversaciones de WhatsApp.
# Vista general de Conversaciones
La **sección de Conversaciones** es el panel principal para **ver, gestionar y organizar** todos los flujos conversacionales que has creado en tu cuenta. Desde aquí puedes revisar el estado de cada conversación, editarla, enviarla o moverla entre folders.
Al ingresar a esta vista encontrarás tres áreas principales:
* **Barra lateral izquierda:** Navegación general de la plataforma.
* **Panel central:** Listado de todas tus conversaciones con herramientas de gestión.
* **Panel derecho:** Explorador de folders personales para organizar tus flujos.
## Barra lateral izquierda
Contiene las secciones principales de la plataforma para que puedas navegar fácilmente entre funcionalidades:
* **Conversaciones:** La vista actual, donde gestionas todos tus flujos.
* **Links de WhatsApp:** Gestiona enlaces directos con parámetros para campañas.
* **Anuncios de Meta:** Configura campañas pagadas en WhatsApp.
* **Plantillas HSM:** Administra mensajes preaprobados por Meta.
* **Centro de métricas:** Accede a métricas detalladas de tus conversaciones.
* **Métricas generales:** Resumen ejecutivo de tu cuenta.
* **Centro de recursos:** Documentación y materiales de ayuda.
* **Configuración:** Preferencias generales de tu cuenta.
* **Idioma:** Cambia el idioma de la plataforma.
También verás el acceso a **Otras plataformas**, como **Sales.ai**.
## Barra superior del módulo de conversaciones
En la parte superior del panel central encontrarás controles principales:
* **Buscar por nombre o ID:** Filtra tus conversaciones escribiendo su nombre o identificador.
* **Seleccionar:** Activa la selección múltiple de conversaciones.
* **Mover a folder:** Envía las conversaciones seleccionadas a un folder específico.
* **Eliminar:** Borra conversaciones seleccionadas.
* **Crear nueva conversación:** Botón destacado para iniciar un nuevo flujo conversacional desde cero.
Además, muestra el **nombre de usuario** y notificaciones de actividad.
## Panel central de conversaciones
Bajo los controles superiores, se despliega el **listado de todas tus conversaciones**.
### Filtros y ordenamiento
* Puedes ordenar por **últimos creados** para ver los flujos más recientes al inicio.
### Tarjetas de conversación
Cada conversación se muestra en forma de **tarjeta individual** con los siguientes datos:
* **Nombre de la conversación:** Identificador editable por el usuario (ejemplo: “Prueba ubicación”).
* **ID único:** Un número interno de referencia (ejemplo: ID: 827653).
* **Usuarios:** Número de usuarios que han interactuado con el flujo.
* **Días transcurridos / Tasa de respuesta:** Según el tipo de flujo (inbound u outbound), muestra métricas clave.
* **Tipo de flujo:** Puede ser **Inbound** (conversaciones que inician los usuarios) o **Outbound** (campañas enviadas por la empresa).
* **Acciones rápidas:**
* **Ver métricas** 📊
* **Editar** ✏️
* **Enviar** (disponible para campañas outbound).
### Acciones adicionales
Si haces click en los tres puntos en la esquina superior derecha de la tarjeta de conversación, verás las siguientes opciones:
* ** Desactivar conversación**: Desactiva la conversación para que no se envíe más mensajes. Los usuarios ya no podrán interactuar con la conversación.
* ** Renombrar**: Edita el nombre de la conversación.
* ** Duplicar**: Duplica la conversación. Es importante notar que la conversación duplicada no tendrá la misma data que la conversación original, solo se duplicarán los bloques de mensaje y el nombre de la conversación.
* ** Reporte despliegues**: Descarga el reporte de despliegues de la conversación.
### Eliminar flujo de conversación
Puedes eliminar una o más conversaciones seleccionándolas y haciendo click en el botón **Eliminar** . Treble mantiene la data de tus conversaciones eliminadas en caso de que quieras recuperarlas.
Para poder recuperar una conversación eliminada, debes contactar a soporte.
## Panel derecho: Folders personales
En el lado derecho de la pantalla verás un **explorador de folders** para organizar tus conversaciones.
* **Ver todos:** Muestra el total de conversaciones (ejemplo: 227).
* **Folders personalizados:** Carpetas que hayas creado (como “AC Demo”, “Demos”, “Marketing”) con el número de conversaciones en cada una.
* **Crear nuevo folder:** Botón para agregar nuevas carpetas personalizadas y organizar mejor tus flujos.
***
## ¿Cómo organizar tus conversaciones?
1. Usa **folders personalizados** para clasificar tus flujos por campaña, objetivo o equipo.
2. Selecciona múltiples conversaciones con el botón **Seleccionar** y usa **Mover a folder** para organizarlas en lote.
3. Filtra por nombre o ID para encontrar rápidamente el flujo que necesitas editar o enviar.
4. Usa **Crear nueva conversación** para diseñar nuevos flujos desde cero con el editor visual.
***
La sección de **Conversaciones** te permite tener **control total y visibilidad completa** sobre todos tus flujos, asegurando que puedas **administrar, editar y enviar** tus conversaciones de WhatsApp Business API de forma **fácil y organizada**.
# Links de WhatsApp
Source: https://help.treble.ai/es/docs/main-platform/whatsapp-links
Aprende a usar los links de WhatsApp en Treble. Estos son enlaces que te permiten medir el rendimiento de tus campañas de marketing y ventas.
## Introducción
Los links de WhatsApp son herramientas poderosas que te permiten medir la cantidad de usuarios que han interactuado con tus enlaces, ya sea haciendo click o escaneando un código QR, y cuántos han enviado un mensaje a través de ellos. Cada link de WhatsApp ofrece la capacidad de rastrear estos datos incluso en la misma línea de WhatsApp, lo cual es invaluable para identificar qué fuentes están generando más leads y qué tipo de conversación prefieren esos leads.
Algunos ejemplos de casos de uso de links de WhatsApp de Treble incluyen:
* **Encuestas en sedes distintas de una cadena de tiendas**: Puedes crear un link de WhatsApp con código QR para cada sede de tu cadena de tiendas, lo que te permite identificar qué sede está generando más encuestas completadas y analizar sus respuestas.
* **Links de referidos**: Puedes establecer un link de WhatsApp con código QR para cada sistema de referidos de tu empresa, lo que te ayuda a determinar qué referido está generando más leads y cuántos leads ha generado.
* **Promociones exclusivas**: Genera un link de WhatsApp para promociones exclusivas que se compartan a través de diferentes canales, permitiéndote medir cuál canal es más efectivo en atraer clientes interesados.
* **Rastrear la fuente online de una campaña de publicidad paga en redes sociales**: Puede que hayas creado una campaña de publicidad paga en redes sociales y quieras saber qué red social está generando la mayor cantidad de ventas. Aún si el CTA (Call to Action) de la campaña es tu mismo flujo de conversación inbound en Treble, puedes usar los links de WhatsApp para rastrear y diferenciar la fuente online de la campaña.
## Crear un link de WhatsApp
Para crear un link de WhatsApp, sigue los siguientes pasos:
Ve a la sección de links de WhatsApp al hacer click en el elemento **Links de WhatsApp** en el menú de la izquierda. Luego has click en el botón ** Crear Nuevo link** para comenzar a crear un nuevo link de WhatsApp.
El panel central está dedicado al formulario para configurar tu link. Incluye los siguientes campos obligatorios:
* **Número de WhatsApp**: Selecciona de una lista desplegable el número aprobado de WhatsApp Business con el que se enviarán los mensajes.
* **Nombre del link**: Define un nombre único para identificar fácilmente el link en tu panel.
* **Selecciona el origen de tus leads**: Elige de un menú desplegable la fuente de origen de tus leads (por ejemplo, Instagram, Facebook, Google, Youtube, LinkedIn, etc.).
* **Escribe un mensaje predeterminado**: Define el texto que aparecerá de forma automática en el chat de WhatsApp cuando el usuario abra el link.
* **Agregar etiqueta:** Puedes añadir una o varias etiquetas para clasificar y diferenciar tus links más fácilmente. Esto es útil para hacer seguimiento y análisis en campañas específicas.
Estas etiquetas se convierten en variables de Treble que pueden ser usadas dentro de tus flujos de conversación.
Una vez que hayas configurado el link de WhatsApp, has click en el botón **Generar link de WhatsApp** para crear el link.
¡Excelente! Ya has creado tu link de WhatsApp.
## Métricas de los links de WhatsApp
Una vez que has creado tu link de WhatsApp, puedes ver las métricas de los links de WhatsApp en la sección de **Links de WhatsApp**. En la parte superior de la pantalla se encuentran **las métricas generales acumuladas** para todos tus links:
* **Total de clics:** Número total de veces que los usuarios hicieron clic en tus links.
* **Total de respuestas:** Cantidad total de mensajes enviados por usuarios a partir de los links.
* **Contactos Facebook:** Total de leads provenientes de campañas o fuentes con origen Facebook.
* **Contactos Google:** Leads generados desde campañas o enlaces con origen Google.
* **Contactos (otros):** Leads generados desde cualquier otro origen definido (como Offline, LinkedIn, Email Marketing, etc.).
Estas métricas te permiten tener una visión rápida del **rendimiento global** de tus estrategias de adquisición por canal.
### Filtros de periodo
A la derecha de las métricas globales puedes aplicar **filtros de tiempo** para segmentar los datos por periodo:
* **Hoy**
* **Ayer**
* **7D (últimos 7 días)**
* **3M (últimos 3 meses)**
* **Selector de calendario personalizado**
Esto te ayuda a analizar el comportamiento de tus campañas en intervalos específicos.
### Barra de acciones
Debajo de las métricas generales encontrarás herramientas para gestionar tus links:
* **Buscar por nombre:** Filtra los links rápidamente por el nombre de la campaña.
* **Origen:** Filtra por el origen de leads (Facebook, Google, LinkedIn, Email Marketing, Offline, etc.).
* **Respuestas:** Filtra los links según la cantidad de respuestas recibidas.
* **Descargar:** Exporta el listado de links y sus métricas en formato descargable para análisis externo.
### Tabla de links
La sección principal muestra un **listado tabular** con todos tus links de WhatsApp creados. Cada fila representa un enlace individual con los siguientes datos:
* **Nombre de campaña:** Nombre asignado al link para fácil identificación (ejemplo: “facebook”, “PLG Google Ads”, “LinkedIn PLO V1”).
* **Fecha de creación:** Día en que se generó el link.
* **Origen:** Canal o medio que has configurado como fuente del lead (Facebook, Google, LinkedIn, Offline, Email Marketing, etc.).
* **Clics en link:** Número de veces que el link fue abierto o clickeado por usuarios.
* **Respuestas:** Mensajes efectivamente enviados por clientes desde el link.
#### Acciones rápidas
A la derecha de cada fila encontrarás íconos de acciones:
* ** Ver detalle:** Puedes ver el detalle de un link específico incluyendo el código QR, el link, opción para copiar el link y descargar el código QR.
* ** Menú de opciones:** Accede a más acciones como editar o eliminar el link.
***
## Preguntas frecuentes
No, Treble no puede saber qué números de teléfono hicieron click en un link aún si no enviaron el mensaje. Cuando un usuario hace click en un link de WhatsApp, el link no tiene información sobre el número de teléfono del usuario. Es solo cuando el usuario envía un mensaje a través del link que Treble puede saber el número de teléfono del usuario.
Si el usuario borra el mensaje predeterminado del link, Treble no podrá rastrear la fuente de tu usuario mediante un link de WhatsApp. La forma en la cual Treble logra atribuir una respuesta en un link de WhatsApp es a través del mensaje predeterminado. Esto ocurre porque Meta no envía información sobre el número de teléfono del usuario que hizo click en el link.
# Failure by payment issue en WhatsApp
Source: https://help.treble.ai/es/docs/meta/error-descriptions/failure-by-payment-issue
Descripción del error `FAILURE_BY_PAYMENT_ISSUE` (código de Meta 131042) que se muestra en los reportes de WhatsApp, y qué hacer si lo ves.
Este estado indica que **Meta rechazó el envío de una plantilla (HSM)** por un problema de **elegibilidad de pago** en la Cuenta de WhatsApp Business (WABA) desde la que se envía.
Corresponde al error `131042 - Business eligibility payment issue` que reporta directamente la API de WhatsApp.
👉 **No significa** que:
* Haya un error en tu flujo, plantilla o configuración dentro de Treble
* El número o el contacto estén bloqueados
* Exista un problema con tu cuenta de Treble o con tu facturación con nosotros
Es un problema de **facturación a nivel del WABA en Meta**, ajeno a Treble.
***
## 💳 ¿Por qué puede suceder?
Antes de entregar una plantilla, Meta valida que el Administrador Comercial (Business Manager) dueño del WABA tenga un método de pago vigente y en buen estado. Este error aparece cuando esa validación falla, por ejemplo porque:
* La tarjeta o método de pago asociado al Business Manager fue rechazada, expiró o fue eliminada
* Hay una factura pendiente de pago con Meta
* El WABA no tiene ningún método de pago configurado
* Se alcanzó el límite de gasto (spending limit) configurado en el Business Manager
Treble envía el mensaje correctamente a la API de WhatsApp; es **Meta quien lo rechaza** antes de intentar entregarlo al usuario final, por esta validación de elegibilidad de pago.
***
## 🧾 ¿Afecta solo un mensaje o todo el envío masivo?
Mientras el problema con el método de pago no se resuelva, Meta puede seguir rechazando cada intento de envío, por lo que este error puede aparecer en varios o en la mayoría de los mensajes de un mismo envío masivo (deployment). Es normal ver algunos mensajes entregados con éxito junto a otros con este error.
***
## 🚨 ¿Qué debo hacer si veo este error?
**No intentes resolverlo directamente con Meta por tu cuenta.** Contacta primero a nuestro equipo de soporte a través del chat dentro de la plataforma, contándonos qué envío o conversación presenta el error.
Nuestro equipo:
1. Revisará el estado del WABA y de la validación de pago con Meta
2. Determinará si el problema puede resolverse internamente, o si es necesario escalar el problema con Meta para que se resuelva
3. Te dará una guía clara del siguiente paso para poder resolver el problema
Así evitas hacer cambios innecesarios en tu cuenta de Meta cuando el origen del problema podría ser otro.
# Failure by unable to contact en WhatsApp
Source: https://help.treble.ai/es/docs/meta/error-descriptions/failure-by-unable-to-contact
Descripción del error `FAILURE_BY_UNABLE_TO_CONTACT` que se muestra en los reportes de WhatsApp.
Este estado indica que **WhatsApp no pudo entregar el mensaje en ese momento específico**, porque no encontró un dispositivo del usuario que pudiera **recibir y procesar correctamente ese tipo de mensaje**.
👉 **No significa** que:
* El número sea inválido
* El usuario te haya bloqueado
* Exista un error en tu cuenta o configuración
Es un **fallo temporal**. Este mensaje de estado puede resultar confuso, pero en la gran mayoría de los casos **no indica un problema grave ni requiere acción de tu parte**.
***
## 📱 ¿Por qué puede suceder?
Este estado suele aparecer en situaciones normales del uso de WhatsApp, por ejemplo:
### 1. El usuario está usando WhatsApp Web
Algunos mensajes (como botones, listas, flujos o funciones nuevas) **solo están disponibles en WhatsApp móvil**.
Si el usuario:
* Está activo en WhatsApp Web
* Pero su teléfono no está disponible (apagado, sin internet, en segundo plano)
WhatsApp no puede entregar el mensaje en ese momento.
***
### 2. La app de WhatsApp del usuario no está actualizada
Algunas funciones nuevas requieren versiones recientes de WhatsApp.
Si el mensaje usa una funcionalidad más nueva que la versión instalada del usuario:
* El mensaje no se puede mostrar todavía
* WhatsApp marca el intento como no entregado temporalmente
***
### 3. Problemas temporales de conexión
También puede ocurrir si:
* El teléfono está sin señal o sin internet
* El dispositivo está apagado
* El sistema cerró WhatsApp para ahorrar batería
***
## ⏳ ¿Por qué el mensaje puede aparecer como `delivered` más tarde?
WhatsApp **reintenta la entrega automáticamente**.
Cuando el usuario:
* Abre WhatsApp en el celular
* Actualiza la app
* Recupera conexión a internet
El mensaje puede entregarse correctamente y cambiar su estado a:
✅ **`delivered` (entregado)**
Esto es **completamente normal** y esperado.
***
## 🧘♂️ ¿Debo preocuparme si veo este estado?
**No.**
Recomendaciones:
* No es necesario reenviar el mensaje inmediatamente
* No indica un error permanente
* No afecta la conversación ni al usuario final
En la mayoría de los casos, el mensaje se entrega solo unos minutos u horas después.
***
## 🧠 Resumen rápido
* `FAILURE_BY_UNABLE_TO_CONTACT` = fallo **temporal**, no definitivo
* Suele ocurrir por uso de WhatsApp Web, versiones antiguas o falta momentánea de conexión
* WhatsApp reintenta la entrega automáticamente
* Es normal que el mensaje termine como **`delivered`** más tarde
# Green Check Linea de WhatsApp
Source: https://help.treble.ai/es/docs/meta/green-check
El Green Check es una insignia verde que se muestra en la línea de WhatsApp, lo que indica que la cuenta ha sido verificada por Meta.
La verificación de una línea de WhatsApp es un proceso que permite a las empresas obtener una insignia verde junto a su nombre, lo que garantiza a los usuarios la autenticidad de la cuenta. Este procedimiento es esencial para generar confianza, especialmente en interacciones comerciales. A continuación, te presentamos los pasos para solicitar y obtener la verificación a través de WhatsApp Business API.
## 💣**Accede a WhatsApp Business API**
* La verificación está disponible para empresas que usan **WhatsApp Business API**. Asegúrate de tener una cuenta registrada a través de un proveedor oficial de servicios de WhatsApp (BSP).
## 🗯️ **Prepara tu cuenta de Facebook Business**
* Antes de verificar la línea de WhatsApp, asegúrate de que tu empresa esté verificada en **Facebook Business Manager**. Debes contar con una cuenta de **Business Manager** activa.
## 🤳🏼**Completa el perfil de WhatsApp Business**
* Ingresa al **Administrador de WhatsApp Business** en Facebook Business Manager.
* Completa los detalles del perfil de tu empresa, como el nombre de la empresa, categoría y la información de contacto.
## 🚀 **Solicita la Verificación**
* En el Administrador de WhatsApp, selecciona la línea que deseas verificar.
* Haz clic en la opción **Solicitar Verificación**. Esto enviará tu solicitud para que WhatsApp revise tu cuenta.
## 🪱 **Revisión de la Solicitud**
* WhatsApp evaluará tu solicitud. Durante esta etapa, revisarán aspectos como la actividad de tu cuenta, el perfil de la empresa y si cumples con sus políticas.
## 🦑 **Recepción del Símbolo de Verificación**
* Si tu solicitud es aprobada, tu cuenta recibirá la insignia de verificación verde junto al nombre de la empresa. Esto confirma que WhatsApp ha verificado la autenticidad de tu empresa.
## 🍄 **Notificación y Seguimiento**
* Recibirás una notificación sobre el estado de la solicitud. En caso de ser rechazada, se te indicarán los pasos a seguir o los problemas a corregir antes de volver a intentarlo.
Con estos pasos, tu línea de WhatsApp podrá obtener la verificación y mejorar la confianza de los clientes al interactuar con tu empresa.
## 🥁 Video Explicativo
# Portafolio comercial de Meta
Source: https://help.treble.ai/es/docs/meta/guide/business-manager
Aprende a crear tu portafolio comercial de Meta para poder conectar tu número de WhatsApp a Treble.ai.
## ¿Qué es el Portafolio comercial de Meta?
El Portafolio Comercial de Meta (Meta Business Portfolio) es una herramienta dentro del ecosistema de Meta Business Suite que permite a las empresas administrar múltiples cuentas de anuncios, páginas de Facebook, cuentas de Instagram, píxeles y otros activos comerciales desde un solo lugar.
Si quieres utilizar WhatsApp Business API, necesitas tener un portafolio comercial de Meta. Esto es un requisito de Meta y no de Treble.ai, es decir, si deseas utilizar otro proveedor de WhatsApp Business API, igualmente necesitas tener un portafolio comercial de Meta.
## ¿Cómo encuentro mi portafolio comercial?
Para encontrar tu portafolio comercial, sigue estos pasos:
1. Ve a
y inicia sesión con tu cuenta de Facebook.
Meta te va a pedir que inicies sesión con tu cuenta de Facebook. Esta puede ser tu cuenta personal o una cuenta de Facebook para tu negocio. Si es la primera vez que vas a iniciar sesión para tu administrador comercial, recomendamos que crees una nueva cuenta de Facebook para tu negocio.
2. En la barra lateral izquierda, selecciona tu **Portafolio comercial**.
Continua con los pasos de activos comerciales si ya cuentas con un portafolio comercial.
## No tengo un portafolio comercial - ¿Cómo puedo crear mi portafolio comercial?
Si no tienes un portafolio comercial, puedes crear uno siguiendo estos pasos:
1. Ve a
y inicia sesión con tu cuenta de Facebook.
2. Meta detecta que no tienes un portafolio comercial y te va a pedir que crees uno. Llena los campos:
* **Nombre de tu negocio y de tu cuenta**
* **Tu nombre y apellido**
* **Correo electrónico del negocio:** Es aqui donde recomendamos que uses un correo electrónico asociado al dominio de tu empresa.
### Error al momento de crear un portafolio comercial
Es posible que al momento de crear un portafolio comercial, te salga un error de que tu cuenta es muy nueva. Esto ocurre porque Meta requiere que tu cuenta tenga actividad previa sobre tu negocio. Por lo tanto, la mejor opción si te sale este error, nuestra recomendación es crear una fanpage.
La recomendación es mostrarle a Meta que tu negocio no es nuevo y que ya tienes una cuenta de Facebook. Para eso, primero creemos una fanpage.
#### ¿Qué es una fanpage?
Una fanpage es una página de Facebook que representa tu negocio. Es una página que puedes usar para interactuar con tus clientes y para promocionar tus productos y/o servicios. Abajo puedes ver un ejemplo de la fanpage de una pastelería en Colombia.
.
2. En el panel de la izquierda, expande la opción de más y selecciona **"Páginas"**.
3. Haz click en **"Crear nueva página".** Sigue los pasos para crear una fanpage.
Una vez creada la fanpage, puedes volver a intentar crear tu portafolio comercial pero recomendamos que al menos generes interacción con tu fanpage y tu cuenta de Facebook. Intenta interactuar con tu fanpage y con tu cuenta de Facebook durante varios días, por ejemplo:
* Invita a tus amigos y/o clientes a que te sigan en tu fanpage de Facebook.
* Sube múltiples fotos y videos en tu fanpage sobre tus productos y/o servicios.
* Comenta y comparte con tus amigos y/o clientes.
* **Muy recomendable:** Has publicidad paga en Facebook en tu fanpage.
## ¿Qué son los activos comerciales de mi Portafolio Comercial de Meta?
Los activos comerciales son elementos como tu fanpage, anuncios, páginas de Facebook, cuentas de Instagram, píxeles y otros activos comerciales. El portafolio comercial de Meta te permite gestionar y unificar todos estos activos comerciales desde un solo lugar. Es recomendable que tengas asociados varios activos comerciales a tu portafolio para asistir en el proceso de verificación de tu cuenta.
### Asociar fanpage a tu portafolio comercial
Para poder asociar tu fanpage a tu portafolio comercial, sigue estos pasos:
1. Ve a
y inicia sesión con tu cuenta de Facebook.
2. En la barra lateral izquierda, selecciona **Configuración**.
3. Una vez hagas click en **Configuración**, te saldrá un panel adicional donde puedes seleccionar **Cuentas** y luego **Páginas**.
4. Selecciona la opción que mejor te ayude, desde aqui puedes asociar tu fanpage a tu portafolio comercial o crear una nueva fanpage.
5. Completa los pasos para asociar tu fanpage a tu portafolio comercial.
### Asociar otros activos comerciales a tu portafolio comercial
En la sección de **Cuentas**, puedes asociar otros activos comerciales a tu portafolio comercial. Recomendamos que asocies todos los activos comerciales que tengas. Por ejemplo, si tienes una cuenta de Instagram, puedes asociarla siguiendo los pasos que se encuentran en la sección de **Cuentas**.
## Completar información del negocio en el portafolio comercial
Finalmente, para poder asociar tu cuenta de WhatsApp a tu portafolio comercial, necesitas completar la información de tu negocio. Para esto, sigue estos pasos:
1. Ve a
y inicia sesión con tu cuenta de Facebook.
2. En la barra lateral izquierda, selecciona **Configuración**.
3. Una vez hagas click en **Configuración**, te saldrá un panel adicional donde puedes seleccionar **"Información del negocio"**.
4. Has click en **Editar**. Completa los pasos para llenar la información de tu negocio.
¡Perfecto! Ahora puedes continuar con el proceso de verificar tu negocio.
## Recomendaciones finales
Recomendamos que en la sección de **Centro de Seguridad** de tu portafolio comercial, dejes los dos primeros elementos en verde 🟢. Esto incluye:
1. **Habilitar la autenticación de dos factores**: Te recomendamos que habilites la autenticación de dos factores para tu cuenta de Meta Business Suite. Importante: Si habilitas la autenticación de dos factores, y pierdes acceso a tu segundo factor de autenticación, no podrás iniciar sesión en tu cuenta de Meta Business Suite y corres el riesgo de perder tu cuenta. Asegurate de guardar tu segundo factor de autenticación en un lugar seguro.
2. **Agregar administradores adicionales**: Te recomendamos que agregues administradores adicionales a tu cuenta de Meta Business Suite. Esto te ayudará a proteger tu cuenta y a prevenir el acceso no autorizado.
# Verificación de Meta
Source: https://help.treble.ai/es/docs/meta/guide/meta-verification
Aprende a verificar tu cuenta de Meta para poder conectar tu número de WhatsApp a Treble.ai.
## ¿Qué es la verificación de Meta?
La **verificación en Meta** es un proceso fundamental para garantizar la autenticidad y seguridad de cuentas empresariales en Facebook e Instagram. La verificación de tu portafolio comercial es necesaria para poder usar WhatsApp Business API, sin embargo, verificar tu negocio también te ayudará con otros productos de Meta como anuncios publicitarios.
Al verificar tu negocio, también evitas suplantación de identidad, lo que te protege de fraudes y protege tu reputación.
## ¿Por qué es necesario hacer la verificación de Meta?
Meta solicita la verificación para confirmar que tu empresa es legítima y evitar fraudes. A su vez, Meta necesita verificar que tu negocio cumpla con las políticas de WhatsApp Business API. Puedes consultar las políticas de Meta en el siguiente enlace:
Al completar este proceso, puedes:
* Aumentar la seguridad de tus activos comerciales.
* Acceder a funciones avanzadas como campañas publicitarias, API de WhatsApp Business y más.
* Cumplir con las políticas de Meta y evitar bloqueos inesperados.
## ¿Dónde se hace la verificación de Meta?
Puedes realizar la verificación en el **Security Center (Centro de Seguridad)** dentro de **Meta Business Manager**. Para acceder:
1. Ingresa a tu cuenta de Meta Business Manager, accediendo a
2. Has click en **Configuración** en el menú de la izquierda
3. Busca el **Centro de Seguridad** haciendo scroll en la sección de **Configuración** y has click. (Es posible que tengas que ingresar tu código de verificación de dos factores)
4. Verifica que tu portafolio comercial esté verificado. Si lo está verás un escudo verde en la caja de **Verificación del Negocio**.
## Mi negocio no está verificado - ¿Cómo lo puedo verificar?
Al acceder al centro de seguridad, encontrarás la caja con la verificación de tu negocio. Es importante notar que hay dos escenarios posibles. Has click en el que corresponda a tu caso:
Aprende cómo habilitar el botón de verificación.
Continua con el proceso de verificación.
## El botón en el Centro de Seguridad está deshabilitado - ¿Cómo lo puedo habilitar?
Si el botón de verificación está deshabilitado, has el siguiente proceso para habilitarlo:
1. **Ingresa a Treble.ai** ingresa a la plataforma de Treble.ai por medio de la siguiente URL:
2. **Has click en Configuración** en el menú de la izquierda
3. **Has click en Líneas WABA**
4. **Has click en el botón Me encuentro en este proceso:** Elige la opción de la derecha para continuar con el proceso de verificación.
Te saldrá un formulario para que inicies el proceso de conexión de WABA. Has click en el botón **Comenzar Recorrido** y luego **Iniciar configuración de WABA**.
### Pasos del formulario
Agrega la información de tu negocio en los campos correspondientes. Vas a tener que llenar información como tu nombre del negocio, dirección de tu sitio web y país.
Deja en los dos campos de WhatsApp la opción predeterminada que te aparece en los dos campos.
En esta sección encotrarás tres campos:
1. **Nombre de tu cuenta de WhatsApp Business**: Este es el nombre interno con el que se identificará tu cuenta de WhatsApp Business. Este nombre no se verá en el chat de WhatsApp. Te recomendamos que uses el nombre de tu negocio seguido de la palabra "Treble". Ejemplo: **"Felipe's Chocolates - Treble"**.
2. **Nombre para mostrar en el chat de WhatsApp**: Este es el nombre que se verá en el chat de WhatsApp. Te recomendamos que uses el nombre de tu negocio. Ejemplo: **"Felipe's Chocolates"**.
El nombre a mostrar en el chat de WhatsApp debe cumplir con las políticas de Meta. Para conocer más sobre las políticas de Meta, puedes visitar el siguiente enlace:
3. **Categoría de tu negocio**: Escoge la categoría de tu negocio. Si no encuentras la categoría que buscas, puedes seleccionar **"Servicios Profesionales"**.
Si el formulario te pide agregar un número de teléfono, **DETENTE AQUÍ ✋🛑**. Con haber completado los pasos anteriores, ya puedes volver a Meta Business Manager y verificar tu cuenta.
Cierra el formulario de la venta emergente y has click en **Explorar plataforma** en la esquina superior izquierda para volver a la plataforma de Treble.ai. De nuevo, estamos deteniendo el proceso aqui para que puedas volver a Meta Business Manager y verificar tu cuenta.
## Proceso de verificación en Meta
Si la verificación está disponible, sigue estos pasos:
1. **Has click en el botón de Empezar Verificación**
2. Sigue los pasos hasta que Meta te pida llenar la información de tu negocio. Si hiciste el paso anterior de agregar la información de tu negocio en el portafolio comercial
, muchos de los datos ya estarán llenos.
3. (Opcional) Escoger tu negocio desde el menú desplegable de **Seleccionar negocio**: Meta intenta identificar tu negocio basado en la información que tienes en tu portafolio comercial y es posible que lo encuentres en la lista. Si no lo encuentras, puedes escoger la opción: **Mi negocio no está en la lista**.
4. **Subir documentos oficiales**: Si escogiste la opción **Mi negocio no está en la lista**, Meta te pedirá subir documentos oficiales de tu negocio para verificarlo. Tienes que subir al menos un documento para poder continuar con el proceso de verificación. Si este documento cuenta con la dirección y número de teléfono de tu negocio, Meta solo te pedirá que subas ese documento. De lo contrario, tendrás que subir un documento adicional para comprobar dirección y número de teléfono.
Recomendamos siempre subir los documentos listados en Meta como recomendados.
Meta personaliza las opciones de documentos que puedes subir dependiendo de tu país, sin embargo, los documentos más comunes son:
* **(Recomendado) Documento de incorporación**: Si tienes un documento que demuestre la incorporación de tu negocio junto con la dirección y número de teléfono, sube una foto del documento.
* **(Recomendado) Registro tributario**: Sube un documento que demuestre la inscripción tributaria de tu negocio.
* **Licencia comercial**: Si tienes una licencia comercial, sube el archivo PDF de la licencia.
* **Extracto bancario**: Si tienes un extracto bancario, sube el archivo PDF del extracto.
* **Factura**: Si tienes una factura, sube un archivo PDF de una factura de algún servicio que utiliza tu negocio, idealmente la factura debe tener la dirección y número de teléfono de tu negocio.
5. Paso final, código de verificación de Meta: Meta te enviará un código de verificación a tu correo electrónico. ¿Recuerdas que te recomendamos que tuvieras servicio de correo electrónico con tu dominio? Ahora es el momento de usarlo. Ingresa una dirección de correo electrónico con tu dominio y escribe el código de verificación enviado por Meta.
Recomendamos que revises tu carpeta de spam para asegurarte de que el correo electrónico llegó.¡Listo! Tu negocio ahora está en proceso de verificación. Este proceso puede durar entre 1 a 2 días.
## Tips y Preguntas frecuentes
Generalmente, Meta te notificará por correo electrónico cuando tu negocio haya sido verificado. Sin embargo, si no recibes un correo electrónico, puedes revisar el centro de seguridad en Meta Business Manager.
Generalmente, la verificación de Meta toma entre 1 a 2 días. Si el proceso se demora más de 2 días, puedes contactarnos a través de nuestro chat de soporte.
## Fui rechazado en la verificación de Meta - ¿Qué hago después?
Si tu verificación fue rechazada, puedes volver a lanzar el proceso de verificación. Sin embargo, antes de volverlo a intentar asegura que:
* La información en el apartado de portafolio comercial esté completa.
* Revisa que la información de tu negocio en el portafolio comercial concuerde con la información de tu negocio en el documento que subiste.
* Si seleccionaste una de las empresas que Meta sugirió en el listado, cuando vuelvas a intentar la verificación, no elijas la misma empresa, sino la opción **Mi negocio no está en la lista**.
* Asegúrate que tu sitio web esté actualizado y no sea una landing page.
* Asegúrate que tu sitio web cumpla con todos los requisitos listados en la sección de
.
## Casos Excepcionales
En algunos casos, aun cuando cumples con todos los requisitos, Meta puede que no te permita completar el proceso de verificación. En este caso, es posible que te salga un error cuando estes ejecutando el paso de escoger tu negocio o que tu negocio no aparezca en el listado de empresas.
Si te ocurre este caso, debes:
1. Ingresar a tu portafolio comercial en Meta Business Manager.
2. Busca la opción de WhatsApp Business Manager accediendo a: **Configuración** en el menú de la izquierda, luego busca **Cuentas** y en cuentas seleccionas la opción **Cuentas de WhatsApp**.
3. Si hiciste el paso de habilitar el botón de verificación con Treble.ai, te saldrá una WABA creada con Treble.ai. Aqui, has scroll en el panel de la derecha y has click en la opción **WhatsApp Manager**.
4. En la parte superior de esta sección, te saldrá un mensaje para solicitar revisión. Has click en el botón **Solicitar revisión**, y sigue los pasos para solicitar la revisión de tu cuenta. Al completar este paso, Meta te vuelve a habiliar el botón de iniciar verificación en el centro de seguridad. Esta revisión puede durar entre 1 a 2 días.
# Preparar tu sitio web
Source: https://help.treble.ai/es/docs/meta/guide/preparing-website
Recomendamos que prepares tu sitio web para que puedas conectar tu número de WhatsApp a Treble.ai.
Meta requiere que tu sitio web cumpla con ciertos requisitos para poder conectar tu número de WhatsApp a Treble.ai. Esto te puede parecer un poco complicado, pero no te preocupes, te guiaremos a través de todo el proceso. Asegura que cumplas con todos los siguientes requisitos:
## Requisitos
### 1. Tener un sitio web con un dominio válido.
Tu negocio no solo debe estar registrado, sino que también debe tener un sitio web con un dominio válido. De esta forma, Meta puede verificar que tu negocio es real y que tienes el control sobre el número de WhatsApp que deseas conectar. Si no tienes un sitio web, te recomendamos que crees uno.
### 2. Nombre legal del negocio en el footer de tu sitio web.
El nombre legal del negocio debe estar en el footer de tu sitio web. Esto es un paso crucial y necesario para que Meta pueda verificar que tu negocio es real y que tienes el control sobre el dominio de tu sitio web. Al agregar este nombre en el footer, Meta podrá verificar que tu sitio web es de tu propiedad y que estás autorizado a usar el dominio.
Por ejemplo, si tu nombre legal es **"Treble.ai INC"**, tu footer debe tener algo como **"Treble.ai INC - Todos los derechos reservados"**.
Consulta con tu proveedor de hosting si necesitas ayuda para agregar este nombre en el footer de tu sitio web.
### 3. Tener servicio de correo electrónico asociado a tu dominio.
Debes tener un servicio de correo electrónico asociado a tu dominio. Es decir, debes tener un correo electrónico que termine en tu dominio. Por ejemplo, si tu dominio es **"treble.ai"**, tu correo electrónico debe ser algo como **"[hola@treble.ai](mailto:hola@treble.ai)"**.
Los correos electrónicos asociados a tu dominio deben estar alojados en tu propio servidor de correo electrónico. No puedes usar servicios de terceros como Gmail, Hotmail, etc.
Consulta con tu proveedor de hosting si necesitas ayuda para agregar este correo electrónico a tu dominio.
### 4. (Recomendado) Tener la dirección física del negocio en el footer de tu sitio web.
Si tienes una dirección física, te recomendamos que la agregues en el footer de tu sitio web. Esto es un paso opcional, pero es muy recomendable para que Meta pueda verificar que tu negocio es real.
### 5. (Recomendado) Tener tu número de teléfono de tu negocio en el footer de tu sitio web.
Si tienes un número de teléfono, te recomendamos que también lo agregues en el footer de tu sitio web. Esto es un paso opcional, pero también ayuda a que Meta pueda verificar que tu negocio es real.
## Resumen de los requisitos
Puedes hacer una revisión rápida de los requisitos que necesitas cumplir para poder conectar tu número de WhatsApp a Treble.ai:
| Requisito | ¿Lo tengo? |
| ------------------------------------------------------------------------------------- | ---------- |
| Tener un sitio web con un dominio válido. | ✅ |
| Tener el nombre legal del negocio en el footer de tu sitio web. | ✅ |
| Tener un servicio de correo electrónico asociado a tu dominio. | ✅ |
| (Recomendado) Tener la dirección física del negocio en el footer de tu sitio web. | ✅ |
| (Recomendado) Tener tu número de teléfono de tu negocio en el footer de tu sitio web. | ✅ |
## Próximos pasos
Ahora que ya tienes tu sitio web listo, puedes continuar con el siguiente paso para conectar tu número de WhatsApp a Treble.ai.
***
## Preguntas Frecuentes
No, si tu sitio web solo recolecta información de los clientes potenciales, no es suficiente. Meta requiere que tu sitio web muestre información sobre tu negocio. Recomendamos agregar contenido relevante sobre tu negocio en tu sitio web.
# Conectar Linea de WhatsApp
Source: https://help.treble.ai/es/docs/meta/guide/welcome
Conoce todos los pasos y requisitos de Meta para poder conectar tu propio número de WhatsApp a Treble.ai.
1. ¿Tienes un negocio registrado?
Para poder conectar WhatsApp a Treble.ai, necesitas tener un negocio registrado legalmente.
Para continuar y poder usar WhatsApp Business API, necesitas tener un negocio registrado. Te recomendamos consultar con un asesor legal para registrar tu negocio.
2. ¿Tienes una página web con dominio propio?
Es necesario tener una página web con dominio propio para poder usar WhatsApp Business API.
Por favor verifica que cumples con los siguientes requisitos:
¿Tienes el nombre legal del negocio en el footer de tu sitio web?
Necesitas tener el nombre legal del negocio en el footer de tu sitio web.
¡Excelente! Has completado todos los requisitos de tu portafolio comercial
Es necesario que tengas un portafolio comercial de Meta, hayas conectado tus activos comerciales y hayas completado toda tu información de tu negocio para poder usar WhatsApp Business API. Aprende más sobre cómo crear un portafolio comercial de Meta
Meta requiere que tu portafolio comercial esté verificado para poder usar WhatsApp Business API. Para rápidamente saber si tu portafolio comercial está verificado, sigue estos pasos:
1. Ingresa a tu cuenta de Meta Business Manager, accediendo a
2. Has click en **Configuración** en el menú de la izquierda
3. Busca el **Centro de Seguridad** haciendo scroll en la sección de **Configuración** y has click. (Es posible que tengas que ingresar tu código de verificación de dos factores)
4. Verifica que tu portafolio comercial esté verificado. Si lo está verás un escudo verde en la caja de **Verificación del Negocio**.
Para continuar y poder usar WhatsApp Business API, necesitas tener tu portafolio comercial verificado. Aprende más sobre cómo verificar tu portafolio comercial
Necesitas tener un número telefónico libre para poder usarlo en WhatsApp Business API.
Por favor verifica que cumples con los siguientes requisitos:
¿Tienes una línea telefónica libre? No debe estar siendo usada actualmente en WhatsApp o WhatsApp Business ni tampoco estar conectada con otro proveedor de WhatsApp Business API.
Debes tener una línea telefónica libre. No debe estar siendo usada actualmente en WhatsApp o WhatsApp Business ni tampoco estar conectada con otro proveedor de WhatsApp Business API. Para más información sobre cómo obtener una línea telefónica libre, puedes visitar
Cumples con todos los requisitos para conectar WhatsApp a Treble.ai 😎
Finalmente, asegurate de tener una cuenta paga de Treble.ai para poder usar WhatsApp Business API.
# Número de WhatsApp
Source: https://help.treble.ai/es/docs/meta/guide/whatsapp-number
Estás en el paso final para poder conectar tu número de WhatsApp a Treble.ai. Aquí te explicamos cómo preparar el número telefónico que usarás para tu WhatsApp Business API.
## ¿Qué significa tener un número de WhatsApp Business API?
Si has usado aplicaciones como WhatsApp o WhatsApp Business, habrás notado que cada cuenta tiene un número telefónico asociado. Este número es el que se usa para enviar y recibir mensajes. Probablemente adquiriste este número telefónico al comprar tu linea telefónica personal o de tu empresa. WhatsApp Business API también requiere un número telefónico para poder enviar y recibir mensajes. Sin embargo, WhatsApp Business API no tiene una aplicación móvil.
El hecho de que WhatsApp Business API no tenga una aplicación móvil, no quiere decir que no puedas enviar y responder mensajes desde tu teléfono o computadora. Precisamente, Treble.ai, como herramienta de WhatsApp Business API, habilita todo un producto digital para que puedas interactuar con tus clientes.
Dado que quieres utilizar WhatsApp Business API para enviar y recibir mensajes, también necesitas un número telefónico asociado a tu cuenta de WhatsApp Business API. Dada esta necesidad, pueden existir los siguientes escenarios:
* **Quieres comprar una nueva línea telefónica y usarla para WhatsApp Business API**: Este es el caso más sencillo. Puedes comprar una línea telefónica nueva y usarla para WhatsApp Business API.
* **Quieres usar una línea existente de WhatsApp**: Puede que tu o tu negocio (usando la aplicación tradicional de WhatsApp) tenga una línea telefónica asociada a WhatsApp. En este caso, puedes usar esa línea para WhatsApp Business API.
* **Quieres usar una línea existente de WhatsApp Business**: Puede que tu o tu negocio (usando la aplicación de WhatsApp Business) tenga una línea telefónica asociada a WhatsApp Business. En este caso, puedes usar esa línea para WhatsApp Business API.
* **Tienes una linea existente de WhatsApp Business API con otro proveedor**: Si ya tienes una línea telefónica asociada a WhatsApp Business API, puedes migrar esa línea a Treble.ai.
Es de suma importancia que evalues cuál es el escenario que mejor refleja tu situación actual y que entiendas las implicaciones de cada escenario.
### Escenario 1: Comprar una nueva línea telefónica
Este es el caso más sencillo. Puedes acercarte a tu proveedor de servicios telefónicos y comprar una línea telefónica nueva. Esta línea telefónica puede ser una línea fija o una línea móvil. No tendrás que hacer ningún tipo de migración de tu linea o backup de tus mensajes. Sin embargo, entendemos que muchas veces los negocios ya tienen una linea telefónica conocida por sus clientes y que prefieren no cambiar. Hablemos por lo tanto del siguiente escenario.
### Escenario 2: Usar una línea existente de WhatsApp ó WhatsApp Business
En este caso, tienes una línea telefónica asociada a WhatsApp o WhatsApp Business. Si quieres usar esa línea para WhatsApp Business API, tendrás que eliminar la asociación de esa línea con WhatsApp o WhatsApp Business.
### Escenario 3: Migrar una línea existente de WhatsApp Business API
En este caso, tienes una línea telefónica asociada a WhatsApp Business API con otro proveedor. Si quieres migrar esa línea a Treble.ai, tendrás que eliminar la asociación de esa línea con el otro proveedor y asociarla con Treble.ai.
#### Escoge el escenario que mejor se adapte a tu situación:
Aprende cómo conectar una nueva línea telefónica.
Aprende cómo usar una línea existente de WhatsApp ó WhatsApp Business.
Aprende cómo migrar una línea existente de WhatsApp Business API.
## Comprar una nueva línea telefónica
Acércate a tu proveedor de servicios telefónicos y compra una línea telefónica nueva. Esta línea telefónica puede ser una línea fija o una línea móvil. En algunos paises existe la opción de adquirir la línea telefónica con un plan de datos y/o telefonía. Esto no es necesario para usar WhatsApp Business API, la linea solo debe tener la capacidad de recibir mensajes SMS o llamadas entrantes al ser ingresada a un teléfono.
Procede a la sección de
## Usar una línea existente de WhatsApp ó WhatsApp Business
Para usar una línea existente de WhatsApp ó WhatsApp Business, recomendamos que hagas los siguientes pasos:
1. **Hacer backup de tus conversaciones de WhatsApp**: Si tienes una línea existente de WhatsApp ó WhatsApp Business, es importante que hagas un backup de tus conversaciones dado que dentro de poco eliminarás la asociación de esa línea con WhatsApp ó WhatsApp Business, por consiguiente no podrás acceder a tus conversaciones anteriores.
Para hacer backup de tus conversaciones de WhatsApp:
1. Accede a la aplicación de WhatsApp.
2. Ve a la sección de configuración.
3. Selecciona la opción de "Conversaciones".
4. Luego, selecciona la opción de "Backup de conversaciones".
5. Sigue las instrucciones para hacer backup de tus conversaciones.
2. **Desasociar de WhatsApp normal ó Business**: Si quieres usar una línea existente de WhatsApp ó WhatsApp Business, tendrás que desasociar esa línea de WhatsApp ó WhatsApp Business.
Para desasociar tu línea telefónica de WhatsApp normal ó Business, puedes seguir estos pasos:
1. Accede a la aplicación de WhatsApp o WhatsApp Business.
2. Ve a la sección de configuración.
3. Selecciona la opción de "Cuenta".
**Es posible reversar que la línea telefónica que va a quedar asociada a WhatsApp Business API se puede regresar a WhatsApp normal ó Business. Sin embargo, esto no es recomendable dado que el proceso tarda 30 días. ¡Confirma que deseas continuar!**
4. Luego, selecciona la opción de "Borrar mi cuenta". ⚠️ (**Lee el aviso de arriba**)
5. Sigue las instrucciones para borrar tu cuenta.
Procede a la sección de
## Migrar una línea existente de WhatsApp Business API
Para poder migrar una línea existente de WhatsApp Business API, sigue los siguientes pasos:
1. Ingresa al portafolio comercial de Meta.
2. Busca la opción de WhatsApp Business Manager accediendo a: **Configuración** en el menú de la izquierda, luego busca **Cuentas** y en cuentas seleccionas la opción **Cuentas de WhatsApp**.
3. Has click en **WhatsApp Business Manager** de la cuenta de WhatsApp que actualmente tiene asociada tu linea.
4. Has click en **número de teléfono** de la cuenta de WhatsApp que actualmente tiene asociada tu linea y luego has click en **Configuración** , de esa linea.
5. Has click en el botón de **más** y luego has click en **Verificación de dos factores**.
6. has click en el botón de **eliminar autenticación de dos factores**. Vas a recibir un correo electrónico de Meta con las instrucciones para eliminar la autenticación de dos factores.
7. ¡Éxito! Ahora puedes migrar tu línea telefónica a Treble.ai directamente desde la plataforma.
Procede a la sección de
## Migrar la línea desde Treble.ai
Una vez hayas desactivado la verificación en dos pasos (2FA) de tu línea con el otro proveedor, sigue los siguientes pasos para migrarla a Treble.ai:
1. **Ingresa a Treble.ai** por medio de la siguiente URL:
2. **Has click en Configuración** en el menú de la izquierda
3. **Has click en Líneas WABA**
4. **Has click en el botón, Conectar línea WABA**
5. En la ventana que aparece, has click en el botón **Migrar número desde otro proveedor**, ubicado en la parte inferior.
6. Treble te mostrará una advertencia recordándote que debes tener desactivada la verificación en dos pasos (2FA) en el número que vas a migrar. Si tienes dudas, puedes consultar la guía de migración enlazada en esa advertencia.
7. Ingresa el número de teléfono (incluyendo el código de país) que quieres migrar desde el otro proveedor.
8. Has click en el botón **Migrar ahora**.
¡Éxito! Tu línea telefónica se ha migrado a Treble.ai. No necesitas ingresar ningún código de verificación para este proceso. Ya puedes volver a la plataforma de Treble.ai y empezar a utilizar tu número de WhatsApp Business API.
Si el proceso de migración falla, Treble te mostrará un mensaje de error indicándote que verifiques que la verificación en dos pasos (2FA) esté desactivada en el número y que lo intentes de nuevo. Si el problema persiste, contacta a nuestro equipo de soporte.
## Preparar la linea para recibir código de verificación
Un paso importante es que la línea telefónica que uses para WhatsApp Business API tenga la capacidad de recibir un código de verificación que Meta enviará durante el proceso. Para ello, te recomendamos que:
1. Si tienes una SIM card, asegurate de que la SIM esté insertada en un teléfono móvil.
2. Si tienes una línea fija, asegurate de que la línea tenga la capacidad de recibir llamadas entrantes.
3. Prueba enviando un mensaje de texto o una llamada a la línea telefónica. Si puedes recibir el mensaje o la llamada, entonces la línea está lista para recibir código de verificación.
## Conectar la línea a Treble.ai
Para conectar la línea a Treble.ai, sigue los siguientes pasos:
1. **Ingresa a Treble.ai** ingresa a la plataforma de Treble.ai por medio de la siguiente URL:
2. **Has click en Configuración** en el menú de la izquierda
3. **Has click en Líneas WABA**
4. **Has click en el botón, Conectar línea WABA:** Elige la opción de la izquierda para continuar con el proceso de conectar la línea.
Te saldrá un formulario para que inicies el proceso de conexión de WABA. Has click en el botón **Comenzar Recorrido** y luego **Iniciar configuración de WABA**.
### Pasos del formulario
Agrega la información de tu negocio en los campos correspondientes. Vas a tener que llenar información como tu nombre del negocio, dirección de tu sitio web y país.
Deja en los dos campos de WhatsApp la opción predeterminada que te aparece en los dos campos.
En esta sección encotrarás tres campos:
1. **Nombre de tu cuenta de WhatsApp Business**: Este es el nombre interno con el que se identificará tu cuenta de WhatsApp Business. Este nombre no se verá en el chat de WhatsApp. Te recomendamos que uses el nombre de tu negocio seguido de la palabra "Treble". Ejemplo: **"Felipe's Chocolates - Treble"**.
2. **Nombre para mostrar en el chat de WhatsApp**: Este es el nombre que se verá en el chat de WhatsApp. Te recomendamos que uses el nombre de tu negocio. Ejemplo: **"Felipe's Chocolates"**.
**IMPORTANTE EN CASO DE MIGRAR UNA LÍNEA EXISTENTE DESDE OTRO PROVEEDOR**: Si estas migrando una línea existente de WhatsApp Business API de otro proveedor a Treble.ai, el nombre para mostrar en el chat de WhatsApp debe ser el mismo que ya estás usando en el otro proveedor. Si no usas el mismo nombre, Meta te va a generar un error y no podrás continuar con el proceso de conexión de la línea.
Podrás cambiar el nombre para mostrar en el chat de WhatsApp después de que hayas logrado conectar la línea a Treble.ai.
El nombre a mostrar en el chat de WhatsApp debe cumplir con las políticas de Meta. Para conocer más sobre las políticas de Meta, puedes visitar el siguiente enlace:
3. **Categoría de tu negocio**: Escoge la categoría de tu negocio. Si no encuentras la categoría que buscas, puedes seleccionar **"Servicios Profesionales"**.
El formulario te va a pedir agregar un número de teléfono, agrega el número de teléfono de la línea telefónica que vas a usar para WhatsApp Business API. Selecciona si vas a recibir el código de verificación por SMS o por llamada.
Una vez que hayas agregado el número de teléfono, escribe el código de verificación que recibiste en el teléfono y has click en el botón **Enviar código de verificación**.
Una vez que hayas agregado el número de teléfono con el código de verificación, Treble te mostrará ésta última vista donde debes escoger la línea telefónica que acabas de configurar de una lista de opciones. (Si tu línea no está presente, o en la lista de opciones, revisa el paso siguiente). Has click en el dropwdown para seleccionar la línea telefónica que acabas de configurar, y luego has click en el botón **Conectar línea a Treble.ai**.
¡Éxito! Tu línea telefónica se ha conectado a Treble.ai. Ya puedes volver a la plataforma de Treble.ai y empezar a utilizar tu número de WhatsApp Business API.
### Mi línea no aparece o no está en la lista de opciones del último paso
Si tu línea no está en la lista de opciones del último paso, significa que Meta no ha aceptado aún el nombre de tu cuenta de WhatsApp, también conocido como **Nombre para mostrar en el chat de WhatsApp** (Display Name). Treble te mostrará la siguiente vista:
Para poder terminar el proceso de conexión de la línea, debes esperar a que Meta acepte el nombre de tu cuenta de WhatsApp. Te puedes quedar en esta vista hasta que Meta acepte el nombre de tu cuenta de WhatsApp, y podrás hacer click en el botón ** Refrescar página** para revisar si el nombre de tu cuenta de WhatsApp ha sido aprobado.
Si quieres revisar el estado de la aprobación del nombre de tu cuenta de WhatsApp, puedes seguir los siguientes pasos:
1. Ingresa a Meta Business Manager por medio de la siguiente URL:
2. Busca la opción de WhatsApp Business Manager accediendo a: **Configuración** en el menú de la izquierda, luego busca **Cuentas** y en cuentas seleccionas la opción **Cuentas de WhatsApp**.
3. Has click en **WhatsApp Business Manager** de la cuenta de WhatsApp que actualmente tiene asociada tu linea.
4. Meta te mostrará los números de teléfono asociados a tu cuenta de WhatsApp. Busca el número de teléfono que acabas de configurar y verifica que abajo del nombre de la cuenta de WhatsApp (Display Name), haya un texto que diga **"Nombre visible a clientes"**. Adicionalmente, verás un cuadro en la parte superior de la pantalla que dirá: **Felicidades! Tu nombre de tu cuenta de WhatsApp ha sido aprobado**.
5. Si el nombre de tu cuenta de WhatsApp no está visible a clientes, debes esperar a que Meta acepte el nombre de tu cuenta de WhatsApp. Este proceso puede durar hasta 2 horas. Puedes revisar el estado de la aprobación del nombre de tu cuenta de WhatsApp refrescando la página de Meta Business Manager.
6. Una vez que Meta haya aprobado el nombre de tu cuenta de WhatsApp, puedes volver a Treble.ai y seleccionar tu línea telefónica en la lista de opciones.
7. Has click en el dropwdown para seleccionar la línea telefónica que quieres configurar, y luego has click en el botón **Conectar línea a Treble.ai**.
¡Éxito! Al seleccionar tu línea telefónica en la lista de opciones y hacer click en **Conectar línea a Treble.ai** has logrado conectar tu línea a Treble.ai.
## Configurar el perfil de tu línea WhatsApp Business API
Para poder configurar el perfil de tu línea WhatsApp Business API, primero te recomendamos que
2. Has click en el menú de la izquierda y selecciona **Configuración**
3. Has click en **Líneas WABA**
4. Has click en el botón **Editar** de la línea que vas a configurar.
5. Llena los campos de la línea con la información correspondiente. Aqui puedes personalizar el nombre de la línea, el nombre de la cuenta, la imagen de perfil y la descripción de la línea.
¡Éxito! Has configurado el perfil de tu línea WhatsApp Business API.
# Plantillas de Carrusel
Source: https://help.treble.ai/es/docs/meta/hsm-templates/carousel
Envía múltiples tarjetas con imagen o video, texto y botones en un solo mensaje de WhatsApp
## Introducción
El template de carrusel te permite enviar una secuencia de tarjetas interactivas directamente en WhatsApp. Cada tarjeta incluye su propia imagen o video, texto y botones de acción, todo dentro de un solo mensaje.
Puedes incluir entre 2 y 10 tarjetas en un mismo carrusel, lo que lo hace ideal para mostrar múltiples productos, destacar diferentes promociones o llevar al usuario directamente a una acción: comprar, llamar o visitar tu sitio web.
***
## ¿Qué incluye un carrusel HSM?
Un carrusel está compuesto por un mensaje principal y una serie de tarjetas:
* **Mensaje principal**: texto que aparece encima del carrusel
* **Tarjetas (2 a 10)**:
* Imagen o video
* Texto descriptivo
* Botones de acción
Todas las tarjetas comparten la misma configuración de botones, pero su contenido puede variar.
## Cómo crear un template de carrusel
Para crear una plantilla HSM de tipo Carrusel, sigue estos pasos:
1. Ve a la sección de **Plantillas HSM** en Treble.
2. Haz clic en "Creación de plantilla HSM".
3. Haz clic en el botón "Carrusel" dentro de la categoría Marketing.
4. Configura la plantilla:
* Ingresa el nombre de la plantilla.
* Selecciona el idioma.
* Escribe el mensaje principal (Body).
* Agrega entre **2 y 10 tarjetas**, cada una con:
* Imagen o video
* Texto
* Botones de acción
5. Haz clic en "Crear Plantilla HSM" para enviarla a revisión.
**Nota**: Una vez crees la plantilla, Meta realiza una revisión de la plantilla. Este proceso puede durar entre 1 a 3 días. Afortunadamente, Meta ha acelerado el proceso de aprobación de plantillas HSM para que sea casi instantáneo.
## Estructura y reglas
Un template de carrusel tiene dos niveles:
* **Mensaje principal (body)**: texto que aparece encima del carrusel
* **Tarjetas (cards)**: cada una con imagen o video, texto y botones
### Límites
* Mínimo **2 tarjetas**
* Máximo **10 tarjetas**
* Máximo **1024 caracteres** en el mensaje principal
* Máximo **160 caracteres** por tarjeta
* Todas las tarjetas de una misma plantilla deben tener los mismos componentes
### Media
* Imagen: JPG, JPEG o PNG (máx. 5 MB)
* Video: MP4 (máx. 16 MB)
### Botones
* Mínimo **1** y máximo **2** botones por tarjeta
* Todas las tarjetas deben tener el **mismo tipo y orden de botones**
Tipos de botones disponibles:
* **Respuesta rápida**: permite al usuario enviar una respuesta predefinida y puede conectarse a flujos
* **Sitio web**: abre una URL
* **Número de teléfono**: inicia una llamada
### Variables
Puedes usar variables como `{{nombre_cliente}}` en:
* El mensaje principal (body)
* El texto de cada tarjeta
* URLs de botones tipo website (dinámicas)
Todas las variables deben tener un valor de ejemplo antes de guardar la plantilla.
Para más detalles sobre cómo funcionan las variables y cómo usarlas en tus flujos, consulta la sección de [personalización de plantillas HSM con variables](../hsm-templates/intro#personalizar-plantillas-hsm-con-variables).
# Plantillas HSM
Source: https://help.treble.ai/es/docs/meta/hsm-templates/intro
Aprende que son las plantillas HSM y como usarlas
## ¿Qué son las plantillas HSM?
Las plantillas HSM (Highly Structured Messages) son mensajes predefinidos que son usados en conversaciones de WhatsApp Business API.
## ¿Por qué Meta requiere plantillas HSM?
Meta implementa las plantillas HSM como una medida de protección para los usuarios de WhatsApp. Este sistema ayuda a:
* Prevenir el spam y mensajes no deseados
* Asegurar que los mensajes comerciales sean relevantes y esperados
* Mantener la calidad de la comunicación empresarial
* Proteger la privacidad de los usuarios
Las plantillas deben ser aprobadas por Meta antes de poder ser utilizadas, lo que garantiza que cumplan con las políticas y estándares de calidad.
## Ventana de mensajería de 24 horas
Cuando un usuario interactúa con un mensaje de una empresa en WhatsApp, se abre una "ventana de mensajería" de 24 horas. Durante este período:
1. La empresa puede enviar mensajes sin necesidad de usar plantillas HSM
2. Se permite una comunicación más fluida y natural
3. Se pueden enviar cualquier tipo de contenido permitido por WhatsApp
Una vez que la ventana de 24 horas expira, la empresa debe usar una plantilla HSM aprobada para iniciar una nueva conversación.
## Categorías de plantillas HSM
Meta clasifica las plantillas en cuatro categorías principales:
### 1. Marketing
* Promociones y ofertas
* Lanzamientos de productos
* Newsletters
* Actualizaciones de marca
* Invitaciones a eventos
* [Carrusel](./carousel) (plantillas con múltiples tarjetas interactivas)
**Nota**: Las plantillas de marketing tienen requisitos más estrictos de aprobación y deben proporcionar una clara opción de opt-out.
### 2. Service (Servicio)
* Confirmaciones de pedidos
* Actualizaciones de envío
* Recordatorios de citas
* Notificaciones de servicio al cliente
* Actualizaciones de estado de cuenta
### 3. Authentication (Autenticación)
* Códigos de verificación
* Confirmaciones de inicio de sesión
* Restablecimiento de contraseña
* Verificación en dos pasos
* Códigos de seguridad
### 4. Utility (Utilidad)
* Confirmaciones de registro
* Actualizaciones de cuenta
* Notificaciones de sistema
* Alertas importantes
* Información de facturación
Cada categoría tiene sus propias directrices y tiempos de aprobación. Por ejemplo:
* Las plantillas de autenticación suelen aprobarse más rápidamente
* Las plantillas de marketing requieren más tiempo de revisión
* Las plantillas de servicio y utilidad tienen un proceso de aprobación intermedio
## ¿Cómo usar las plantillas HSM en Treble?
Treble te permite crear plantillas HSM y usarlas en tus flujos conversacionales.
Para crear una plantilla HSM, sigue estos pasos:
1. Ve a la sección de **Plantillas HSM** en Treble.
2. Haz clic en "Nueva plantilla".
3. Ingresa el contenido de la plantilla.
1. Ingresa el nombre de la plantilla.
2. Escoge la categoría e idioma de la plantilla.
3. Puedes personalizar el contenido de la plantilla en tres partes:
* Header: Encabezado de la plantilla.
* Body: Cuerpo de la plantilla.
* Footer: Pie de página de la plantilla.
4. Ingresa el idioma de la plantilla.
4. Haz clic en "Crear Plantilla".
**Nota**: Una vez crees la plantilla, Meta realiza una revisión de la plantilla. Este proceso puede durar entre 1 a 3 días. Afortunadamente, Meta ha acelerado el proceso de aprobación de plantillas HSM para que sea casi instantáneo.
Crear plantillas HSM efectivas es clave para tener una comunicación exitosa
con tus clientes. Lee nuestra guía para conocer las mejores prácticas para
crear plantillas HSM.
## Personalizar plantillas HSM con variables
Puedes personalizar plantillas HSM con variables. Las variables son información dinámica que puedes usar en tus plantillas HSM. Por ejemplo, puedes usar variables para personalizar el mensaje de bienvenida de un cliente, o para enviar el nombre de un cliente en un mensaje.
Para crear una variables, solo debes escribir el nombre de la variable en el contenido de la plantilla. Por ejemplo, si quieres enviar el nombre de un cliente en un mensaje, puedes escribir `{{nombre_cliente}}`.
Es importante entender la estructura de las variables. Recomendamos que el
nombre de la variable sea un nombre claro y descriptivo, que no contenga
caracteres especiales o espacios. La variable debe estar entre llaves dobles ` {{}}`. Adicionalmente, recomendamos que la variable esté en minúscula y que no
contenga espacios.
### Ejemplo de uso de variables
Como puedes ver en el ejemplo, la variable `{{name}}` se reemplaza por el nombre del cliente en el mensaje y la variable `{{company}}` se reemplaza por el nombre de la empresa en el mensaje.
Treble reconoce las variables que usas en tus plantillas HSM y te permite usarlas en tus flujos conversacionales. Cuando vayas a enviar una conversación, podrás especificar el valor de las variables para cada usuario al que quieras enviar la conversación.
Aprende a enviar conversaciones con variables en Treble.
## Estado de aprobación de plantillas HSM
Puedes ver el estado de aprobación de tus plantillas HSM en la sección de **Plantillas HSM** en Treble. Cuando recién crees una plantilla, su estado será "Pendiente".
Una vez que Meta aprueba la plantilla, su estado cambiará a "Aprobado".
Te recomendamos que siempre revises el estado de aprobación de tus plantillas HSM antes de usarlas en tus flujos conversacionales. Dado que el tiempo de aprobación de Meta puede variar, es importante que siempre estés al pendiente de este estado, solo debes refrescar la página para ver el estado actualizado.
Desde esta vista también puedes ver el estado de aprobación de cada plantilla. Hay diferentes estados de aprobación:
* **Aprobado** 🟢: La plantilla ha sido aprobada por Meta. La plantilla puede ser usada en tus flujos conversacionales.
* **Pendiente** 🟡: La plantilla está en proceso de aprobación.
* **Rechazado** 🔴: La plantilla ha sido rechazada por Meta. La plantilla puede ser rechazada por diferentes razones, como contenido inapropiado, falta de claridad en la opción de opt-out, o falta de cumplimiento con las políticas de WhatsApp.
## Editar plantillas HSM
Puedes editar una plantilla HSM en la sección de **Plantillas HSM** en Treble. Para ello, haz clic en el botón de **"Editar"** en la plantilla que deseas editar. Al hacer clic, se te redirigirá a la vista de edición de la plantilla. Ten en cuenta que solo puedes editar el contenido de la plantilla, no puedes cambiar la categoría, nombre o idioma de la plantilla.
## Preguntas frecuentes
No, no es necesario que aprobes todos los bloques de mensajes. Solo debes
aprobar el bloque de mensaje que inicia la conversación. Cuando tu cliente
responda, puedes usar cualquier bloque de mensaje.
# Plantillas de utilidad
Source: https://help.treble.ai/es/docs/meta/hsm-templates/utility
Aprende que son las plantillas de utilidad y como usarlas
## Introducción
Los modelos de mensajes en la API de WhatsApp Business tienen diferentes categorías, y la tarificación varía según la clasificación. Los mensajes de **marketing** son más costosos que los **utilitarios**, por lo que es esencial optimizar la redacción para garantizar que las plantillas sean aprobadas como **utilidad**. Según Meta, los mensajes utilitarios deben estar vinculados a interacciones previas del usuario y tener un carácter transaccional.
Esta guía proporciona estrategias, palabras clave y ejemplos para estructurar mensajes que cumplan con estos criterios, reduciendo costos sin comprometer la comunicación con los clientes.
***
## Directrices Generales para la Clasificación como Utilidad
1. **Basarse en una acción previa del usuario:**
* Hacer referencia a un evento pasado, como una compra, una cita programada o una solicitud de soporte.
* Evitar mensajes genéricos o promocionales sin un contexto previo.
2. **Mantener un tono informativo y transaccional:**
* Priorizar el propósito de actualización, notificación o seguimiento.
* Evitar mensajes con un fuerte enfoque comercial o persuasivo.
3. **Evitar términos promocionales y ofertas directas:**
* Palabras como "descuento", "promoción", "oferta especial" o "gana" indican marketing.
* Optar por expresiones neutrales como "seguimiento", "actualización" y "continuación".
4. **Usar preguntas para incentivar la interacción:**
* En lugar de botones, finalizar el mensaje con una pregunta abierta para generar interacción sin parecer una campaña promocional.
***
## Estructura Ideal de un Mensaje Utilitario
* **Apertura contextualizada:** Referencia a la acción previa del usuario.
* **Información relevante:** Explicación objetiva sobre el estado de la acción.
* **Llamado a la acción sutil:** Invitación a continuar con el proceso sin un tono promocional.
### Ejemplos Prácticos
### 1. Reenganche de Leads
**Marketing (más caro):**
"¡Tenemos una oferta especial para ti! Obtén un 10% de descuento en tu próxima compra. Accede al enlace y aprovéchalo."
**Utilidad (más barato):**
"¡Hola! Notamos que completaste nuestro formulario recientemente. ¿Podemos ayudarte a continuar con tu solicitud?"
### 2. Carrito Abandonado
**Marketing (más caro):**
"¡Tu carrito aún te espera! Finaliza tu compra ahora y obtén envío gratis."
**Utilidad (más barato):**
"Notamos que tu intento de compra no se completó. Si necesitas ayuda para finalizar el pedido, estamos a tu disposición."
### 3. Postventa y Recomendaciones
**Marketing (más caro):**
"¿Te gustó tu última compra? Descubre nuestros productos relacionados y aprovecha descuentos exclusivos."
**Utilidad (más barato):**
"Basándonos en tu última compra, podemos recomendarte un producto complementario. ¿Te gustaría más detalles?"
### 4. Recordatorios y Citas
**Marketing (más caro):**
"¡No te lo pierdas! Últimos cupos para nuestro evento especial. Inscríbete ahora y asegura tu lugar."
**Utilidad (más barato):**
"Te recordamos que tienes un evento programado para \[fecha]. Si necesitas más información, estamos aquí para ayudarte."
***
## Palabras Clave para Mensajes de Utilidad
### Palabras Positivas para la Clasificación como Utilitaria
* ✅ "De acuerdo con tu última acción…"
* ✅ "Notamos que iniciaste…"
* ✅ "Vimos que tu intento de…"
* ✅ "Dando seguimiento a tu solicitud…"
* ✅ "Aquí está la actualización sobre…"
* ✅ "Tu pedido/cita ha sido recibido…"
* ✅ "Si necesitas asistencia, estamos disponibles…"
### Palabras a Evitar (Indicadores de Marketing)
* 🚫 "Oferta exclusiva"
* 🚫 "Descuento imperdible"
* 🚫 "Promoción por tiempo limitado"
* 🚫 "Gana ahora"
* 🚫 "Última oportunidad para comprar"
* 🚫 "Descubre nuestros lanzamientos"
***
## Estrategias Avanzadas
* **Dividir la comunicación en etapas:** Enviar primero un mensaje utilitario y, después de la interacción del cliente, introducir información promocional.
* **Probar y ajustar:** Presentar diferentes versiones de plantillas y monitorear las aprobaciones de Meta para identificar patrones eficaces.
***
## Conclusión
La reducción de costos en la API de WhatsApp requiere una comprensión refinada de la categorización de mensajes por parte de Meta. Adoptar un tono neutral, hacer referencia a acciones pasadas y evitar disparadores promocionales son estrategias clave para garantizar la aprobación como **mensaje utilitario**. Siguiendo estas directrices, tu empresa puede ahorrar significativamente mientras mantiene una comunicación efectiva con los clientes.
# Meta y Treble
Source: https://help.treble.ai/es/docs/meta/overview
Entiende todo sobre Treble, Meta y WhatsApp
Meta, anteriormente Facebook, es una empresa que tiene como objetivo conectar a las personas a través de sus productos. WhatsApp es uno de sus productos más importantes. Treble es una empresa que ayuda a las empresas a conectarse a WhatsApp usando la API de WhatsApp Business.
¿Qué significa esto para ti?
## Un poco de historia
Meta adquirió WhatsApp en 2014 por \$19 mil millones de dólares. WhatsApp era una aplicación de mensajería que ya tenía 450 millones de usuarios activos. Meta vio la oportunidad de usar WhatsApp para conectar a más personas y expandir su alcance. A medida que la aplicación creció, Meta empezó a ver la oportunidad de usar WhatsApp para conectar a las empresas con sus clientes.
En 2016, Meta lanzó WhatsApp Business, una aplicación que permite a las empresas conectarse a WhatsApp. WhatsApp Business es una aplicación gratuita que permite a las empresas enviar y recibir mensajes. Tiene más funcionalidades que la aplicación de WhatsApp normal y está optimizada para negocios. Por ejemplo, permite a las empresas tener un perfil comercial, que es un perfil diseñado específicamente para negocios.
En 2018, Meta lanzó WhatsApp Business API, una API que permite a las empresas conectarse a WhatsApp y enviar y recibir mensajes con sus clientes. WhatsApp Business API es una API de acceso restringido, disponible solo para empresas que tienen acceso directo de Meta o que cuentan con un socio que tiene acceso a la API. Treble es uno de estos socios y utiliza la API de WhatsApp Cloud para permitir a las empresas enviar y recibir mensajes a gran escala.
En el 2022, Treble se convirtió en uno de los socios de Meta para ofrecer la API de WhatsApp Business. Es decir, Treble es un BSP (Business Service Provider) que permite a las empresas conectarse a WhatsApp y enviar y recibir mensajes con sus clientes.
# Nombres de usuario de WhatsApp y BSUID (Business-Scoped User ID)
Source: https://help.treble.ai/es/docs/meta/usernames-and-bsuid
Meta está cambiando la forma en que se identifica a los contactos de WhatsApp. Aquí te explicamos qué es un BSUID y un nombre de usuario de WhatsApp, qué cambia en tus mensajes entrantes y salientes, y cómo lo maneja Treble por ti.
Meta está implementando un cambio en la forma en que WhatsApp identifica a las personas con las que hablas. Hasta ahora, cada contacto se identificaba por su **número de teléfono**. Eso está cambiando: los usuarios de WhatsApp ahora pueden adoptar un **nombre de usuario** y, si lo hacen, pueden elegir no compartir su número de teléfono con las empresas.
Para que esto sea posible, Meta ahora envía un nuevo identificador permanente con cada contacto: el **Business-Scoped User ID (BSUID)**. Esta página te explica qué es, qué cambia, y qué (si algo) necesitas hacer.
**No se rompe nada si no haces nada.** Treble resuelve contactos, mantiene las conversaciones conectadas, y envía mensajes correctamente sin importar si un contacto se identifica por número de teléfono, nombre de usuario, o solo por BSUID. Esta página existe para que entiendas *por qué* puedes ver un contacto sin número de teléfono, y qué significa eso.
## ¿Qué es un BSUID?
Un **Business-Scoped User ID** es un identificador único, generado por Meta, para un usuario de WhatsApp, específico para tu negocio. Es el único identificador que Meta siempre incluye con cada mensaje entrante o estado de mensaje, tenga el usuario un nombre de usuario configurado o no, y comparta su número o no.
* Se ve como una cadena con prefijo de código de país, por ejemplo `US.13491208655302741918`.
* Está **limitado a nivel de portafolio de negocio** — la misma persona escribiéndole a dos negocios distintos recibe un BSUID diferente para cada uno.
* **No se puede usar para plantillas de autenticación (OTP)** — esas siguen requiriendo un número de teléfono, ya que dependen de verificación basada en número.
## ¿Qué es un nombre de usuario de WhatsApp?
Un nombre de usuario es un identificador opcional y legible (como `@tunombre`) que un usuario de WhatsApp puede reservar para su cuenta, similar a un nombre de usuario en otras apps de mensajería o redes sociales. Un usuario que tiene un nombre de usuario **puede elegir ocultar su número de teléfono a las empresas** — en ese caso, vas a ver su nombre de usuario (si te escribe con uno configurado) y su BSUID, pero no su número.
Un nombre de usuario es opcional y lo controla el usuario. El número de teléfono también puede volver a aparecer más adelante — Meta lo muestra de nuevo si hubo una interacción reciente (dentro de los últimos 30 días) o si el contacto existe en la libreta de contactos de tu negocio.
## Por qué está pasando esto
Hasta ahora, el número de teléfono era el ancla de todo: cómo se identificaba, se hacía match, y se le mandaban mensajes a un contacto. Meta está desacoplando eso — el número de teléfono pasa a ser *algo que un contacto puede compartir*, no algo con lo que siempre puedes contar.
Los BSUID empiezan a aparecer en los webhooks entrantes para todos los contactos, tengan o no un nombre de usuario configurado.
Se abre globalmente la reserva de nombres de usuario — tanto para usuarios de WhatsApp como para negocios (mira las preguntas frecuentes más abajo para saber cómo configurar uno para tu propio número). Después, la activación se va habilitando por país en las semanas siguientes.
Las APIs de envío empiezan a aceptar un BSUID directamente (vía el parámetro `recipient`) como alternativa a un número de teléfono (`to`).
La adopción es completamente voluntaria del lado del usuario final — la mayoría de tus contactos van a seguir escribiéndote con su número de teléfono visible, exactamente como antes.
## Cómo identifica Treble a un contacto
Treble rastrea **tres** identificadores para cada contacto en vez de solo uno:
| Identificador | De dónde sale | ¿Siempre presente? |
| ------------------ | -------------------------------------------------- | ---------------------------------------------- |
| Número de teléfono | El clásico `wa_id` | No — se omite una vez que el usuario lo oculta |
| Nombre de usuario | El handle de WhatsApp, si el usuario configuró uno | No — es opcional |
| BSUID | El campo `user_id` de Meta | Sí — siempre se envía |
Cuando Treble necesita encontrar o crear un contacto, revisa en este orden: **primero número de teléfono**, después **BSUID**, y después **nombre de usuario**. Esto mantiene el match de los contactos con teléfono exactamente como funcionaba siempre, y solo recurre a BSUID/nombre de usuario cuando no hay número con qué trabajar.
## Mensajes entrantes
```mermaid theme={null}
flowchart LR
A[El contacto envía un mensaje de WhatsApp] --> B{¿Incluye número de teléfono?}
B -- Sí --> C[Match/creación de contacto por teléfono]
B -- No --> D{¿El BSUID ya es conocido?}
D -- Sí --> E[Match con el contacto existente por BSUID]
D -- No --> F[Se crea un nuevo contacto solo con BSUID]
C --> G[La conversación continúa normalmente]
E --> G
F --> G
```
Cuando llega un mensaje entrante sin número de teléfono, Treble:
1. Busca el contacto por BSUID. Si ya conoce ese BSUID (de un mensaje anterior, o porque el número de teléfono se recuperó antes), la conversación continúa exactamente igual que con cualquier otro contacto.
2. Si es la primera vez que ve ese BSUID, Treble crea un nuevo contacto anclado a él. El contacto se comporta con normalidad en tus flujos, reportes e historial de conversación — simplemente no va a tener número de teléfono hasta que haya uno disponible.
3. Si el contacto comparte un número de teléfono más adelante (ver la sección **Recuperar un número de teléfono** más abajo), Treble lo vincula automáticamente al contacto ya existente anclado por BSUID — no se crea ningún duplicado, y el historial de la conversación se mantiene intacto.
## Mensajes salientes
Enviar un mensaje funciona igual sea que apuntes a un contacto por número de teléfono o por BSUID — Treble maneja la diferencia automáticamente por ti. Las campañas, plantillas y automatizaciones no necesitan ningún cambio.
**Las plantillas de autenticación (OTP) siempre requieren un número de teléfono.** Si un contacto solo tiene BSUID y necesitas mandarle una plantilla de autenticación, primero vas a necesitar su número de teléfono — mira la siguiente sección.
## Recuperar un número de teléfono
Si tienes un contacto sin número de teléfono y realmente lo necesitas (por ejemplo, para mandar una plantilla de autenticación, o para sincronizar con un CRM que solo hace match por teléfono), Treble soporta el botón de WhatsApp **Request Contact Info** (Solicitar información de contacto).
Agrega un mensaje con el botón **Request Contact Info** a tu flujo, dirigido al contacto que solo tiene BSUID.
Si acepta, WhatsApp te comparte su número de teléfono — esto siempre requiere consentimiento, el contacto tiene que aceptar explícitamente.
El número de teléfono se vincula al contacto existente de forma automática. Sin trabajo manual, sin contactos duplicados.
Este botón todavía está en beta privada del lado de Meta y se está desplegando de forma gradual. Una vez que esté disponible de forma general, no vas a necesitar hacer ningún cambio de tu lado para empezar a usarlo.
## Soporte en HubSpot
La [integración de Treble con HubSpot](/es/docs/integrations/hubspot/welcome) soporta contactos identificados por BSUID y nombre de usuario de fábrica.
* Se crean automáticamente dos properties nuevas de contacto en HubSpot la primera vez que sincroniza tu integración: **WhatsApp Business Scope ID** (`whatsapp_business_scope_id`) y **WhatsApp Username** (`whatsapp_username`).
* Cuando Treble busca un contacto en HubSpot, revisa primero el número de teléfono, y recurre a BSUID o nombre de usuario cuando no hay número con qué buscar.
* Los contactos nuevos creados desde Treble incluyen estos campos automáticamente, igual que pasa con `treble_created` y otras properties que administra Treble.
* Los contactos que ya existían en HubSpot se van completando con estos campos automáticamente a medida que interactúan — no hace falta ningún backfill manual de tu parte.
Es poco probable, pero si la tienes, no es un conflicto de nuestro lado — Treble solo *lee* estos campos para hacer match de contactos, así que si ya estás llenando algo útil ahí, eso juega a tu favor.
### La única limitación real
Si un contacto **ya existe en tu CRM** porque te escribió antes *con* su número de teléfono, y esa misma persona más adelante te manda un mensaje nuevo **sin** compartir su número (solo con nombre de usuario/BSUID), Treble no va a poder reconocer que es la misma persona — el contacto viejo nunca quedó etiquetado con su nombre de usuario/BSUID, y esa es la única información disponible en ese momento. En ese caso puntual, se crea un **contacto nuevo y separado** en tu CRM en vez de hacer match con el existente.
Esto no es algo que podamos evitar — es una consecuencia directa de que Meta le permita a los usuarios ocultar su número de teléfono después del hecho. También es un caso muy puntual: solo afecta a contactos que primero escribieron con número de teléfono y después lo ocultan, sin que haya habido antes ninguna interacción que le permitiera a Treble etiquetar su registro existente.
Para integraciones de CRM distintas a HubSpot, el match solo por número de teléfono sigue siendo el comportamiento actual — vamos a extender este mismo soporte de BSUID/nombre de usuario a nuestras otras integraciones de CRM próximamente.
## Preguntas frecuentes
No. El envío, las conversaciones, los reportes y las plantillas siguen funcionando igual. Esto lo maneja Treble de forma transparente.
No, no cambia nada sobre cómo funcionan los reportes para ti.
Sí — le mandas mensajes de la misma forma, Treble resuelve el destinatario correcto (teléfono, BSUID, o nombre de usuario) automáticamente.
No se pueden enviar hasta que tengas un número de teléfono para ese contacto. Usa el botón de Request Contact Info (sección **Recuperar un número de teléfono** más arriba) para pedirlo, con su consentimiento.
No — es una funcionalidad de la Plataforma de WhatsApp Business que está implementando Meta. Treble lo soporta automáticamente; no hay ninguna configuración que prender.
No. Tu Phone Number ID se mantiene igual, y las conversaciones existentes no se ven afectadas.
Sí, si tu WABA/número cumple con los requisitos de elegibilidad de Meta (negocio verificado, nombre de visualización aprobado). Esto se configura directamente en el WhatsApp Manager de Meta (**Account tools → Phone numbers → selecciona el número → pestaña Profile → Username**), o vía la Username API de Meta — Treble no tiene una interfaz para reservarlo, ya que es una configuración de cuenta del lado de Meta.
No para tu uso diario de Treble. El despliegue de *reserva y activación* de nombres de usuario está pasando gradualmente por país, con el cronograma completamente a cargo de Meta. Sin importar ese cronograma, el manejo que hace Treble de contactos solo-BSUID está activo en todos lados, así que ya estás cubierto para cuando llegue a tu mercado. Confirma directamente en el WhatsApp Manager de Meta el estado actual para un país en particular — no lo podemos garantizar desde nuestro lado.
## Fuentes
Para el detalle técnico completo directamente de Meta:
* [Meta for Developers — Business-Scoped User IDs](https://developers.facebook.com/documentation/business-messaging/whatsapp/business-scoped-user-ids/)
## Siguientes pasos
Mira todo lo que Treble sincroniza con HubSpot.
Entiende el panorama completo de cómo Treble trabaja con Meta.
# WhatsApp, WhatsApp Business y WhatsApp Business API
Source: https://help.treble.ai/es/docs/meta/wa-wabiz-api
Entiende todo sobre WhatsApp, WhatsApp Business y WhatsApp Business API
## Entendiendo la API de WhatsApp Business
La API de WhatsApp Business es una plataforma que permite a las empresas conectarse a WhatsApp y enviar y recibir mensajes con sus clientes. Sería imposible entender Treble sin comprender la API de WhatsApp Business. Por esta razón, es necesario entender todo el ecosistema de WhatsApp. WhatsApp tiene tres productos principales.
### Aplicación de WhatsApp
Esta es la aplicación que tú, como usuario, tienes en tu teléfono. Es una aplicación gratuita que te permite enviar y recibir mensajes. Esta app de mensajería es utilizada por 2 mil millones de personas en todo el mundo y permite a los usuarios chatear con sus amigos y familiares.
### Aplicación de WhatsApp Business
Esta es la aplicación que las empresas usan para comunicarse con sus clientes. Es una aplicación gratuita que permite a las empresas enviar y recibir mensajes. Tiene más funcionalidades que la aplicación de WhatsApp normal y está optimizada para negocios. Por ejemplo, permite a las empresas tener un perfil comercial, que es un perfil diseñado específicamente para negocios.
### API de WhatsApp Business
Esta es la API que las empresas usan para conectarse a WhatsApp y enviar y recibir mensajes de manera masiva. Es una API de acceso restringido, disponible solo para empresas que tienen acceso directo de Meta o que cuentan con un socio que tiene acceso a la API. Treble es uno de estos socios y utiliza la API de WhatsApp Cloud para permitir a las empresas enviar y recibir mensajes a gran escala.
Cuando uses la API de WhatsApp Business, ten en cuenta algunas limitaciones. Estamos acostumbrados a que tenemos una aplicación, sea de WhatsApp o de WhatsApp Business en nuestro teléfono. Sin embargo, cuando usamos la API de WhatsApp Business, no tenemos una aplicación en nuestro teléfono. Adicionalmente, no podemos hacer llamadas o crear grupos de WhatsApp.
Veamos más de cerca la API de WhatsApp Cloud.
## API de WhatsApp Business
Como se mencionó anteriormente, Treble es un socio de la API de WhatsApp Business. Esto significa que Treble tiene acceso a la API de WhatsApp Cloud. Con esta API, podemos generar una cuenta comercial de WhatsApp (WABA) para nuestros clientes. Si alguna vez has recibido un mensaje de una empresa en WhatsApp, has interactuado con la API de WhatsApp Business. Seguramente reconoces estas cuentas, aquí tienes un ejemplo:
Como puedes ver, la cuenta comercial es una cuenta verificada. Esto significa que la empresa tiene un perfil verificado en WhatsApp. Esto ayuda a la empresa a generar más confianza y destacarse de otros negocios en WhatsApp.
También habrás notado que el mensaje contiene un enlace clickeable. Estos mensajes son especiales de la API de WhatsApp Business y se llaman Mensajes Interactivos. Más adelante hablaremos sobre ellos.
### Flujo simple de un mensaje en WhatsApp
Veamos cómo funciona un flujo simple de mensajes en WhatsApp. Supongamos que una empresa quiere enviar un mensaje a un cliente. La empresa tiene una cuenta comercial de WhatsApp (WABA) y el cliente usa la aplicación de WhatsApp normal. La empresa quiere enviar un mensaje al cliente.
1. La empresa envía un mensaje al cliente usando la API de WhatsApp Business.
2. El cliente recibe el mensaje de la empresa.
3. El cliente responde al mensaje.
4. La empresa recibe la respuesta del cliente.
Como puedes ver, el flujo de mensajes es bastante sencillo. La empresa envía un mensaje, el cliente lo recibe y responde, y la empresa recibe la respuesta.
¡Genial! La empresa puede enviar y recibir mensajes. Pero ¿qué pasa si la empresa quiere enviar un mensaje a múltiples clientes? ¿O si quiere responder con un mensaje específico según la respuesta del cliente? ¿O incluso si quiere actualizar la información del cliente en su CRM?
Aquí es donde la API de WhatsApp Business se vuelve más interesante.
Si una empresa quisiera hacer esto, necesitaría construir sistemas sofisticados que manejen el flujo de mensajes. Aquí es donde entra Treble. Treble ayuda a las empresas a construir sistemas avanzados que gestionan la mensajería de WhatsApp sin complicaciones, proporcionando una plataforma web simple para crear y administrar conversaciones.
## Mensajes en la API de WhatsApp Business
Imagina que eres una empresa con acceso a la API de WhatsApp Business. Suena bien, ¿verdad? Ahora puedes enviar y recibir mensajes de tus clientes. Pero, ¿qué significa esto realmente?
Si tuvieras todos los números de teléfono de los usuarios de WhatsApp en el mundo, ¿podrías enviarles un mensaje a todos? ¿Y qué hay del contenido del mensaje? ¿Podrías enviar un enlace a todos ellos para que prueben tu nueva startup: "Insulina para perros gorditos"?
Bueno, la respuesta es no. La API de WhatsApp Business tiene restricciones sobre lo que se puede enviar y recibir. Vamos a explorar esas restricciones.
La Sesión de WhatsApp
Meta (empresa matriz de WhatsApp) regula estrictamente la manera en que las empresas pueden comunicarse con sus clientes a través de la API de WhatsApp Business. Esto ayuda a Meta a garantizar que la plataforma de WhatsApp sea un espacio seguro para todos los usuarios.
Imagina que constantemente recibes mensajes de SPAM de una empresa. Sería molesto, ¿verdad? Probablemente dejarías de usar WhatsApp y convencerías a tus amigos de cambiarse a otra plataforma, como Telegram. Meta quiere evitar esto, por lo que ha implementado ciertas restricciones en la mensajería empresarial.
Antes de que una empresa pueda enviar un mensaje a un usuario, este debe pasar por un proceso de verificación. Meta permite este proceso mediante la creación de un Mensaje Altamente Estructurado (HSM, por sus siglas en inglés), también conocido como plantilla.
Este mensaje debe ser aprobado por Meta y puede tardar hasta 48 horas en ser aprobado.
Conoce más sobre los HSMs en nuestra documentación.
Además, el HSM permite a las empresas aprovechar la API para enviar mensajes interactivos.
Como puedes ver, estos mensajes tienen muchas más capacidades que los simples mensajes de texto a los que estamos acostumbrados.
# Políticas de la Plataforma de WhatsApp Business
Source: https://help.treble.ai/es/docs/meta/waba-policies
Entiende todo sobre las políticas de la Plataforma de WhatsApp Business
### Políticas de Negocios y Comerciales de WhatsApp Business
Meta monitorea las cuentas de WhatsApp Business que violan repetidamente las políticas de Negocios y Comerciales.
La política comercial de WhatsApp se utiliza para determinar si una empresa puede vender sus productos y servicios utilizando las funciones comerciales de WhatsApp: [https://www.whatsapp.com/legal/commerce-policy/](https://www.whatsapp.com/legal/commerce-policy/).
La Política de Mensajes de WhatsApp Business determina el uso aceptable de los Productos de WhatsApp Business en general: [https://business.whatsapp.com/policy](https://business.whatsapp.com/policy)
* Prohibiciones
* Contenido ilegal, fraudulento o engañoso
* Violación de derechos de propiedad intelectual
* Discriminación o discurso de odio
* Acoso o bullying
* Violencia o amenazas
* Restricciones
* Venta de productos y servicios regulados
* Contenido sexual o para adultos
* Juegos de azar y apuestas
* Requisitos
* Cumplimiento de leyes y regulaciones aplicables
* Protección de la privacidad y datos de los usuarios
* Transparencia en las prácticas comerciales
Es importante que las empresas estén al tanto de estas políticas y las sigan rigurosamente para mantener el acceso a la Plataforma de WhatsApp Business. De lo contrario, las consecuencias de las violaciones son:
* Advertencias y restricciones temporales para violaciones menores
* Suspensión o cierre de la cuenta para violaciones graves o repetidas
* Posible bloqueo permanente del uso de la plataforma
### Avisos y notificaciones
🔔 Las notificaciones de las violaciones se mostrarán en el Centro de notificaciones del Administrador de Negocios y como un banner en el Administrador de WhatsApp; se enviarán como un correo electrónico a todos los administradores configurados en el Administrador de Negocios; se enviarán como notificaciones de webhooks a los que se hayan suscrito.
### Consecuencias
Inicialmente, recibirán una advertencia con información sobre la política que se violó. Si la cuenta viola repetidamente las categorías de política de alto riesgo (contenido para adultos, venta de alcohol y tabaco, drogas, juegos de azar y suplementos no seguros) de nuestra Política de Comercio, pueden ocurrir algunas acciones, incluyendo:
* **Bloqueo de 1 o 3 días en el envío de mensajes** iniciados por la empresa y en la adición de otros números de teléfono a la cuenta.
* **Bloqueo de 5 o 7 días en el envío de mensajes iniciados por la empresa y en respuestas** a mensajes iniciados por el cliente, así como en la adición de otros números de teléfono a la cuenta.
* Bloqueo de cuenta indefinido en la apertura de conversaciones, que solo puede ser eliminado mediante apelación
⚠️ Si la empresa no realiza mejoras después de varias advertencias y limitaciones de funciones, **la cuenta puede ser permanentemente desactivada en la Plataforma de WhatsApp Business**. También pueden limitar o eliminar la empresa de WhatsApp si su cuenta recibe un alto volumen de retroalimentación negativa de los usuarios.
### Ver detalles de violación y apelación
En caso de que una empresa sea notificada, se pueden ver los detalles de la violación y hacer una apelación - es posible hacer una apelación de todas las violaciones de política dentro del plazo de 90 días.
* **Cómo ver detalles de la violación de política en la Página de Inicio de Soporte para Empresas**
Comprueba cómo ver los detalles de violación de política de tu cuenta de WhatsApp Business:
1. Accede a la [**Página de Inicio de Soporte para Empresas**](https://business.facebook.com/business-support-home).
2. Haz clic en **Ver mis cuentas** debajo de la sección **Mis cuentas**.
3. Desplázate hacia abajo hasta ver el portafolio empresarial al que está conectada la cuenta restringida de WhatsApp Business. Puede estar escrito **Activos con restricción** junto a él.
4. Haz clic en el portafolio empresarial.
5. Desplázate hacia abajo hasta la sección **Cuentas de WhatsApp**, donde verás la cuenta restringida de WhatsApp Business. Puede estar escrito **Problemas en la cuenta** o **Cuenta deshabilitada** junto a ella.
6. En la pestaña **Disponible para revisión** de la sección **Problemas de actividad**, haz clic en el problema relacionado con la política.
7. Haz clic en **Ver detalles** junto al problema relacionado con la política para ver los detalles de la violación, incluyendo:
1. Resumen de la política violada y un enlace a la política.
2. Información sobre restricciones activas en la cuenta y lo que sucede si la violación ocurre nuevamente.
3. Cómo evitar futuras violaciones de políticas.
4. Qué puedes hacer para resolver la violación de la política, si es posible.
5. Cómo hacer una apelación.
Si crees que tu cuenta no violó nuestra política, puedes hacer una apelación. Aprende más sobre cómo solicitar una revisión a continuación.
* **Cómo hacer una apelación y pedir una revisión**
Comprueba cómo hacer una apelación de una restricción en tu cuenta de WhatsApp Business y pedir una revisión de la violación de la política:
1. Sigue los pasos anteriores para acceder a la pestaña **Disponible para revisión** de la sección **Problemas en la actividad**.
2. Selecciona el problema con la política para el que deseas hacer una apelación.
3. Haz clic en **Solicitar revisión**.
4. Selecciona un **Motivo de la apelación**.
5. \[OPCIONAL] Proporciona más detalles para ayudar al equipo de revisión a entender mejor tu problema.
6. Haz clic en **Enviar**.
Tu solicitud será enviada. Normalmente, las revisiones tardan 24 horas. La decisión puede resultar en la reversión del problema. Es posible ver el estado de la revisión en la pestaña **En revisión**.
* Las actualizaciones de violación incluyen esta información:
* Resumen de la política violada y un enlace a los términos en cuestión
* Ejemplos de contenido permitido o no permitido basado en esa política
* Información sobre restricciones activas en la cuenta y lo que sucede si la violación ocurre nuevamente
* Orientaciones para evitar futuras violaciones de la política y enlaces a recursos útiles
* Explicaciones sobre cómo hacer una apelación
### Consejos para evitar violaciones de política en WhatsApp Business
Para garantizar el cumplimiento de las políticas de WhatsApp y mantener una buena reputación en la plataforma, las empresas deben:
* **Conocer las políticas:** Familiarízate con la Política Comercial y la Política de Mensajes de WhatsApp Business.
* **Obtener consentimiento:** Siempre pide permiso antes de enviar mensajes de marketing a los clientes.
* **Respetar los límites de mensajes:** Evita enviar spam o contenido no solicitado.
* **Mantener la calidad del contenido:** Asegúrate de que tus mensajes sean relevantes y útiles para los destinatarios.
* **Ofrecer opción de cancelación:** Permite que los clientes opten por no recibir más mensajes fácilmente.
* **Monitorear el feedback:** Presta atención a las respuestas de los clientes y ajusta tu estrategia según sea necesario.
* **Actualizarse regularmente:** Mantente atento a los cambios en las políticas de WhatsApp Business.
* **Usar plantillas aprobadas:** Utiliza modelos de mensaje pre-aprobados por WhatsApp cuando sea posible.
* **Respetar horarios adecuados:** Evita enviar mensajes en horarios inconvenientes.
* **Entrenar a tu equipo:** Asegúrate de que todos los empleados que usan la plataforma entiendan las políticas y mejores prácticas.
* **Prestar atención a la frecuencia con la que envías mensajes:** evita enviar muchos mensajes a tus clientes en un corto período de tiempo.
Siguiendo estos consejos, las empresas pueden minimizar el riesgo de violaciones y mantener una presencia positiva en la Plataforma de WhatsApp Business, evitando restricciones o suspensiones de cuenta.
### Calificación de los números de WhatsApp Business
La calificación de los números de WhatsApp Business se basa en los mensajes recientes que tus clientes recibieron en los últimos siete días.
Depende de los comentarios y opiniones de tus clientes, como los **motivos para bloquear tu número de teléfono** y otros informes de errores. Cuando los usuarios bloquean tu empresa, pueden seleccionar un motivo, como:
* **Ya no lo necesito**
* **No me suscribí**
* **Spam**
* **Mensajes ofensivos**
* **Ningún motivo**.
Puedes encontrar tu calificación de calidad en la pestaña **Números de teléfono** del Administrador de WhatsApp de Meta. La columna **Calificación de calidad** muestra los niveles de calidad, que incluyen:
* **Verde:** calidad alta
Si tu empresa mantiene una clasificación de calidad **Alta**, podrá cumplir con los requisitos para usar más funciones.
* **Amarillo:** calidad media
* **Rojo:** calidad baja
Si tu calificación de calidad es media o baja, puedes pasar el cursor sobre ella en el Administrador de WhatsApp para consultar más información sobre los motivos del bloqueo, si están disponibles
🔔 Recibirás un correo electrónico y una notificación en Meta Business Manager cuando ocurran las siguientes situaciones:
* El estado de un número de teléfono se cambia a **Marcado** o el estado **Marcado** se elimina.
* Hay un cambio en los límites de mensajes de un número de teléfono.
Puedes hacer clic en el icono ubicado en la columna Configuración para consultar la clasificación de calidad de los últimos 30 días. Puedes ver la puntuación de calidad más baja que la empresa recibe en un día determinado, lo que te permitirá comprender mejor los posibles factores que impulsan la caída o aumento de la clasificación de calidad en los últimos 30 días.
### Cambio del estado y límite de mensajes en WhatsApp Business
El cambio del estado y el límite de mensajes son medidas implementadas por WhatsApp Business para garantizar la calidad de las interacciones entre empresas y clientes.
* Límite de mensajes
Los límites de mensajes determinan el número máximo de conversaciones iniciadas por la empresa que cada número de teléfono puede iniciar en un período continuo de 24 horas. Existen cuatro niveles de límites:
* 1.000 conversaciones iniciadas por la empresa por número de teléfono en 24 horas
* 10.000 conversaciones iniciadas por la empresa por número de teléfono en 24 horas
* 100.000 conversaciones iniciadas por la empresa por número de teléfono en 24 horas
* Cantidad ilimitada de conversaciones iniciadas por la empresa en 24 horas
**Cambio de estado:** Se refiere al cambio en el estado de una conversación entre una empresa y un cliente. Estos son los significados de cada estado:
* **Conectado:** puede enviar mensajes salientes dentro del límite de mensajes establecido para usted.
* **Marcado:** este estado se activa cuando la calificación de calidad del número de teléfono cambia a "Baja" y está en camino de descender a un nivel de mensajes más bajo. Las empresas no pueden actualizar los niveles de límites de mensajes si su estado es "Marcado". Si la calificación de calidad:
* **Mejora a una calidad alta o media dentro de siete días** desde que el estado cambió a Marcado, este volverá a ser Conectado y **su nivel de límite de mensajes no se verá afectado.**
* **No mejora a una calidad alta o media dentro de siete días** desde que el estado cambió a Marcado, este volverá a ser Conectado. Sin embargo, **su límite de mensajes disminuirá al siguiente nivel.**
* **Restringido:** este estado se activa cuando alcanza su límite de mensajes, independientemente de su calificación de calidad. Mientras el estado esté Restringido, no podrá enviar mensajes salientes hasta que hayan pasado 24 horas, pero podrá continuar respondiendo a los mensajes iniciados por los clientes.
# Salud de la Línea de WhatsApp
Source: https://help.treble.ai/es/docs/meta/whatsapp-line-health
Aprende a mantener la salud de tu línea de WhatsApp. Con esta guía, podrás mantener tu línea en buen estado y evitar penalizaciones.
WhatsApp es un canal poderoso para comunicarte con tus clientes—pero solo si la **salud de tu línea** está en buen estado. Si los usuarios bloquean o reportan tus mensajes, o si violas las políticas de WhatsApp, tu capacidad de enviar mensajes puede verse restringida o incluso eliminada.
Esta guía explica cómo funciona la salud de tu línea, qué puede dañarla y cómo mantenerla en buen estado.
## ¿Qué es la Salud de la Línea de WhatsApp?
La **salud de tu línea** es la puntuación de reputación que se le asigna a tu número de WhatsApp Business API. WhatsApp monitorea cómo los usuarios responden a tus mensajes. Si muchas personas te bloquean o te reportan, tu calidad disminuye. Si interactúan contigo, tu calidad se mantiene alta.
### Niveles de Calidad en WhatsApp:
* **Verde**: Alta calidad (buena interacción, pocas quejas)
* **Amarillo**: Calidad moderada (algunas quejas)
* **Rojo**: Baja calidad (altas tasas de queja – riesgo de penalización)
## ¿Por Qué Importa la Salud de la Línea?
Una línea de mala calidad puede resultar en:
* **Límites de mensajes más bajos** (por ejemplo, de 100.000 a 10.000 mensajes/día)
* **Restricciones temporales** (estado "Con advertencia" o "Restringida")
* **Bloqueos permanentes** (pierdes acceso al canal)
Una buena salud asegura comunicación fluida y entregabilidad confiable.
## Razones Comunes por las que se Sanciona una Línea
1. **Altas tasas de bloqueo o reporte**\
Los usuarios se molestan o confunden con tus mensajes.
2. **Mensajes sin consentimiento (opt-in)**\
Contactas a personas que no han aceptado recibir tus mensajes.
3. **Baja relevancia o interacción**\
Tus mensajes se ignoran o parecen spam.
4. **Violaciones de política**\
Envías contenido prohibido o mal usas las plantillas.
## Como revisar la salud de la linea en meta
Cada vez que haces un despliegue con la línea que activaste en Treble, también puedes chequear la salud de la línea directamente desde Meta. Esto te ayuda a monitorear la calidad y a hacer ajustes cuando sea necesario. Aquí te puedo enseñar cómo puedes revisar esta calidad. Tener visibilidad de esto te ayudará a hacerte cargo de tus propias campañas y a saber qué es lo que mejor funciona para tu empresa.
Para revisar la calidad debes.
1. Ingresar a business.facebook con tus credenciales. (recuerda que este paso lo debe de hacer alguien que tenga permisos de admin)
2. Dale clic al WABA que creaste con Treble y en la parte de abajo busca "Administrador de WhatsApp". Dale clic ahí también.
3. En este nuevo panel encontrarás la línea o líneas que tienes en tu WABA. Para revisar la salud, haz clic en el ícono de la tuerca de la línea que desees verificar.
4. En la parte de "Insights" podrás encontrar la calidad de la línea de los últimos 30 días.
Esta información es muy valiosa ya que se divide en tres partes: alta, media y baja. Aquí puedes saber exactamente cuándo la línea cae en calidad baja y analizar qué tipo de campaña estabas realizando ese día. Esto te permite tener control sobre lo que envías y mejorar tus futuros envíos.
## Como revisar la calidad de HSM y estado dentro de META
1. Ingresar a business.facebook con tus credenciales. (recuerda que este paso lo debe de hacer alguien que tenga permisos de admin)
2. Para revisar la calidad de las plantillas debes de hacerle click a “Administrar Plantillas”.
Aquí verás todas las plantillas que has creado en Treble y podrás ver en qué estado se encuentran.
Las plantillas HSM se deben crear directamente desde TrebleCuando hagas algún cambio en una plantilla en Treble, debes revisar si en Meta ese cambio está aprobado.
***
## 7 Formas de Mantener Sana tu Línea de WhatsApp
Combina mensajes de marketing con **mensajes utilitarios** (como actualizaciones de pedidos o recordatorios). El contenido útil genera confianza y reduce los bloqueos.
Usa respuestas rápidas, botones o preguntas para motivar la respuesta del usuario. Si responden, mejora la salud de tu línea.
Envía mensajes relevantes según comportamiento, intereses o etapa del cliente. Evita enviar contenido genérico a todos.
Evita enviar mensajes en la noche o todos los días. Hazlo durante horas laborales o basado en patrones previos de interacción.
Solo envía mensajes a usuarios que dieron su consentimiento, y permite que se den de baja fácilmente. No hacerlo lleva a sanciones.
Envía plantillas para aprobación, no cambies su contenido después, y no mezcles contenido promocional con transaccional.
Revisa tu panel de WhatsApp Manager con frecuencia. Si baja la calidad o recibes advertencias, actúa de inmediato.
## Resumen
| Haz Esto ✅ | Evita Esto ❌ |
| ----------------------------------- | ---------------------------------------------- |
| Envía contenido útil y relevante | Hacer spam con promociones frecuentes |
| Respeta el opt-in y opt-out | Enviar mensajes sin consentimiento |
| Monitorea tu calidad constantemente | Ignorar advertencias de estado rojo o amarillo |
| Segmenta y personaliza los mensajes | Usar el mismo mensaje para todos |
| Promueve la interacción del usuario | Transmitir sin esperar respuestas |
***
## Consejo Final
**WhatsApp es un privilegio, no un canal garantizado.**
Cuida tu número como un activo crítico. Cuando los clientes confían en tus mensajes, verás más interacción—y más resultados.
# Bienvenido a Treble
Source: https://help.treble.ai/es/docs/welcome
Treble es una herramienta que te permite crear flujos de conversación personalizados para tus casos de uso de ventas y marketing en WhatsApp. Adicionalmente, Treble se puede integrar con tus sistemas de información (CRM) como HubSpot y Salesforce para automatizar y optimizar tus procesos de mensajería por WhatsApp.
## Primeros Pasos
Si eres nuevo en Treble, comienza aquí para aprender lo esencial y poder crear tus primeras conversaciones en WhatsApp.
Crea y envía tu primera conversación outbound en Treble.
Utiliza nuestra API para integrar Treble con tus sistemas de información.
Descubre como puedes integrar Treble con tu CRM u otros sistemas de información.
# Bienvenido
Source: https://help.treble.ai/es/home
Bienvenido a Treble.ai
Empieza a usar Treble.ai en minutos.
Conoce más sobre Treble, WhatsApp y Meta.
Intégrate y escala usando nuestra API y SDKs.
Explora la plataforma de agentes de Treble.
Explora las integraciones de Treble.
Explora las herramientas y guías para construir con Treble.
# Ubicación variable
Source: https://help.treble.ai/es/api-reference/editor/location
Aprende a configurar ubicación variable en tus flujos de conversación. Esto te permitirá agregar ubicación de forma dinámica en tus conversaciones.
## Enviar ubicación
En el editor de Treble, puedes enviar una ubicación a un usuario. Esto te permitirá agregar ubicación de forma dinámica en tus conversaciones.
Normalmente, lo haces de la siguiente manera:
1. Dirígete al nodo de la conversación donde quieras enviar la ubicación.
2. Has click en el botón de adjuntar .
3. Vas a escoger la opción **Ubicación **.
4. Se desplegará un modal donde podrás escribir la dirección de la ubicación que deseas enviar.
5. ¡Listo! Ahora, tus usuarios van a recibir la ubicación que le enviaste.
Ahora, vamos a conocer cómo puedes hacer para que la ubicación no sea un contenido estático, sino que sea dinámico. Para esto, sigue los siguientes pasos:
1. Dirígete al nodo de la conversación donde quieras adjuntar el multimedia.
2. Has click en el botón **Adjuntar **.
3. Vas a escoger la opción **Ubicación **.
4. Ahora, en vez de escribir la dirección de la ubicación, vas a escribir el nombre de la variable. En nuestro ejemplo, la vamos a llamar `{{location}}`. Esta variable es una `user_session_key`.
5. ¡Listo! Ahora, esta variable (en nuestro caso `{{location}}`) va a esperar la latitud y longitud de la ubicación que quieras enviar. El formato de la variable es el siguiente:
```json theme={null}
{
"user_session_keys": [
{
"key": "location",
"value": '{"latitude": 47.123456, "longitude": -4.123456, "address": "[Address text]"}'
}
]
}
```
Nota que el valor de la variable es un JSON pero se envía como un string.
¡Listo! Ahora sabes cómo enviar una ubicación de forma dinámica en tus conversaciones.
## Capturar ubicación de un usuario para enviarla a un webhook
Igualmente, puedes capturar la ubicación de un usuario para enviarla a un webhook. Para esto, sigue los siguientes pasos:
Ingresa a Treble.ai por medio de la siguiente URL:
Ve a la sección de "Conversaciones" y haz click en el botón **"Crear Conversación".** También puedes configurar un webhook de lectura de mensaje en un flujo existente. Para esto, ve a la sección de "Flujos" y haz click en el botón **"Editar" ** de tu flujo.
En el flujo, encuentra o crea un nodo de captura de ubicación. Este nodo es un **Bloque de Mensaje Simple** que va a hacer la pregunta al usuario sobre su ubicación.
Ahora, vamos a hacer doble click en el bloque de mensaje, se desplegará un panel a la izquierda. En este panel, vamos a hacer scroll hasta encontrar la sección de **Guardar Respuesta**. Vas a activar el switch y vas a configurar la variable de la siguiente manera:
* **Tipo de respuesta**: `Ubicación`
* **Nombre de la variable**: Puede ser cualquier nombre, en nuestro ejemplo vamos a usar `ubicacion_cliente`.
Ahora, vamos a hacer doble click en el camino/flecha que sale del bloque de mensaje y conecta con el siguiente bloque. Se desplegará un campo de texto en la parte superior. En este campo, vamos a agregar el endpoint al que quieres que se envíe la solicitud HTTP cuando este mensaje reciba la respuesta del usuario.
Si estás en un flujo nuevo, haz click en el botón **"Publicar Conversación"** para guardar el flujo. Si estás en un flujo existente, haz click en el botón **"Guardar"** para guardar los cambios.
¡Listo! Ahora, cuando un cliente envíe su ubicación al nodo de captura de ubicación, el webhook se activará y enviará una solicitud HTTP a tu endpoint configurado en Treble con la ubicación del cliente.
Recuerda que el formato de la variable de ubicación es el siguiente:
```json theme={null}
{
"user_session_keys": [{"key": "ubicacion_cliente", "value": '{"latitude": 47.123456, "longitude": -4.123456, "address": "[Address text]"}'}]
}
```
# Multimedia variable
Source: https://help.treble.ai/es/api-reference/editor/media
Aprende a configurar multimedia variable en tus flujos de conversación. Esto te permitirá agregar imágenes, videos, audios y archivos adjuntos y enviarlos de forma dinámica en tus conversaciones.
## Adjuntar multimedia - Multimedia variable
En el editor de Treble, puedes adjuntar multimedia a tus mensajes. Esto te permitirá agregar imágenes, videos, audios y archivos adjuntos y enviarlos de forma dinámica en tus conversaciones.
Normalmente, lo haces de la siguiente manera:
1. Dirígete al nodo de la conversación donde quieras adjuntar el multimedia.
2. Selecciona el tipo de multimedia que deseas adjuntar.
3. Selecciona el archivo que deseas adjuntar.
4. Haz clic en **Adjuntar**.
Ahora, vamos a conocer cómo puedes hacer para que el contenido multimedia no sea un contenido estático, sino que sea dinámico. Para esto, sigue los siguientes pasos:
1. Dirígete al nodo de la conversación donde quieras adjuntar el multimedia.
2. Has click en el botón **Adjuntar **.
3. Vas a escoger la opción **Variable**.
4. Esto abrirá un modal donde podrás definir el nombre de la variable. En nuestro ejemplo, la vamos a llamar `media_url`. Esta variable es una `user_session_key`.
5. ¡Listo! Ahora, esta variable (en nuestro caso `media_url`) va a esperar la URL de la imagen, video, audio o archivo adjunto que quieras adjuntar.
La URL de la imagen, video, audio o archivo adjunto debe ser una URL pública. Para revisar si es una URL pública, puedes abrirla en tu navegador. Si puedes ver el contenido, entonces es una URL pública.
## ¿Cómo se maneja esta variable?
Tienes las siguientes opciones para manejar esta variable:
En este caso, cuando subas un archivo CSV, el contenido de la columna `media_url` debe ser la URL de la imagen, video, audio o archivo adjunto que quieras adjuntar. Esto te permitirá enviar la URL del archivo personalizada para cada usuario.
Por ejemplo:
| country\_code | cellphone | name | media\_url |
| ------------- | ---------- | ------ | -------------------------------------------------------------- |
| 57 | 3132392346 | Felipe | [https://example.com/image.jpg](https://example.com/image.jpg) |
| 34 | 622902416 | Camila | [https://example.com/video.mp4](https://example.com/video.mp4) |
Aprende cómo enviar una conversación outbound.
En este caso, cuando hagas una llamada a la API de Treble, debes enviar el contenido de la variable `media_url` en el cuerpo de la llamada. Esta variable hará parte de los `user_session_keys` que se envían en la llamada.
Por ejemplo:
```json theme={null}
{
[...],
"user_session_keys": [
{
"key": "media_url",
"value": "https://example.com/image.jpg"
}
]
}
```
Aprende cómo desplegar un flujo de conversación por API.
En este caso, cuando hagas una llamada a un webhook, y antes de llegar al nodo de la conversación con el nodo que tiene la variable `media_url`, puedes llamar a un webhook, y en la respuesta de este webhook, puedes enviar la URL de la imagen, video, audio o archivo adjunto que quieras adjuntar.
Puedes agregar la URL de la imagen, video, audio o archivo adjunto en la respuesta de un webhook mediante los `user_session_keys`.
¡Listo! Ahora puedes adjuntar multimedia de forma dinámica en tus conversaciones.
# Desplegar un flujo de conversación
Source: https://help.treble.ai/es/api-reference/endpoints/deploy
open-api-files/treble-api-es.json POST /deployment/api/poll/{poll_id}
Este endpoint permite desplegar un conversación a una lista de usuarios definidos por su número de teléfono y código de país. También permite programar despliegues para una fecha posterior.
Recuerda que para usar este endpoint, debes haber obtenido tu llave de API en la sección de **Desarrolladores** de la plataforma Treble.
## Seleccionar el número que despliega (empresas multicanal)
Para empresas multicanal, puedes elegir desde qué número de celular se desplegará al usuario usando `user_session_keys`. Si quieres que el primer número realice el despliegue, basta con agregar la clave `deployment_squad` y su valor correspondiente será `DS_[CELLPHONE]`. Puedes agregar varios *deployment squads* para que distintos números puedan desplegar.
```json theme={null}
"user_session_keys": [
{
"key": "deployment_squad",
"value": "DS_[CELLPHONE]"
}
]
```
# Obtener los agentes de tu empresa
Source: https://help.treble.ai/es/api-reference/endpoints/get-agents
open-api-files/treble-api-es.json GET /agent/company/agents
Devuelve los agentes de tu cuenta que pueden recibir conversaciones. Úsalo para conocer el `id` y el `email` de cada agente, que son los valores que debes devolver desde tu endpoint cuando usas el destino **API** del bloque de Métodos de transferencia.
Solo se devuelven los agentes **activos**, por lo que cualquier agente de la respuesta puede recibir una conversación.
Este endpoint vive en el host de la plataforma de agentes, `agent-api.treble.ai`, y no en `main.treble.ai`.
# Obtener todas las conversaciones
Source: https://help.treble.ai/es/api-reference/endpoints/get-convos
open-api-files/treble-api-es.json GET /poll/api/all
Este endpoint permite obtener todas las conversaciones (flujos) que pertenecen a tu empresa.
# Obtener historial de una sesión
Source: https://help.treble.ai/es/api-reference/endpoints/get-session-history
open-api-files/treble-api-es.json GET /devapi/session/{session_id}/history
Este endpoint, dado un ID de sesión, devuelve el historial completo de mensajes para esa sesión específica.
# Obtener todas las sesiones
Source: https://help.treble.ai/es/api-reference/endpoints/get-sessions
open-api-files/treble-api-es.json GET /devapi/poll/{poll_id}/sessions
Este endpoint, dado un ID de poll, devuelve los metadatos de todas las sesiones de manera paginada. Por defecto, trae los primeros 1000 registros del año actual. Se pueden usar parámetros opcionales para controlar el rango de fechas y la paginación.
# Actualizar una sesión
Source: https://help.treble.ai/es/api-reference/endpoints/session-update
open-api-files/treble-api-es.json POST /session/{session_external_id}/update
Este endpoint permite actualizar las claves de sesión de un usuario específico y continuar la conversación iniciada previamente. El webhook desencadenado por la primera respuesta del usuario proporcionará el session_external_id necesario para esta solicitud.
# Integrar tu propia IA en Treble
Source: https://help.treble.ai/es/api-reference/guides/your-ai
Aprende a integrar tu propia IA en Treble para que pueda responder preguntas de tu usuario.
## Antes de empezar
Antes de empezar con esta guía, te recomendamos que leas múltiples artículos para entender conceptos como variables de sesión, webhooks, y request trigger.
Comprende cómo usar variables de sesión en Treble.
Comprende cómo usar webhooks en Treble.
Comprende cómo usar request trigger en Treble.
Este artículo explica cómo conectar tu sistema de inteligencia artificial (IA) con los flujos conversacionales de Treble. Esta integración permite generar respuestas dinámicas para tus usuarios a partir de los datos procesados en tu backend. A continuación, te mostramos cómo estructurar tu flujo correctamente:
## Bloque inicial
El primer paso es crear un **bloque de inicio** que formule una pregunta al usuario, como por ejemplo: “¿Tienes alguna duda?”, “¿Cómo te puedo ayudar hoy?”.
En la **línea de salida** de este bloque, haz clic para **agregar la URL del webhook** que va a disparar la solicitud a tu sistema.
Guarda la respuesta del usuario en este bloque inicial para usarla como variable en el código. Para esto, activa la opción "guardar respuesta" y asigna un nombre a la variable que se enviará en el body del webhook.
## Procesamiento y respuesta desde tu sistema
Una vez que el usuario responde:
1. Tu sistema recibirá la información.
2. Procesará esa información utilizando la IA.
3. Enviará un *response* a Treble con la **respuesta generada**.
4. Esta respuesta debe actualizar las variables de la sesión, y será la que se muestra al usuario.
## Requests que toman más de 10 segundos: uso de `[REQUEST_TRIGGER]`
Cuando el procesamiento de la IA puede tomar más tiempo, es necesario insertar un **bloque intermedio** antes de enviar la respuesta:
* Este bloque debe tener una **opción etiquetada como `[REQUEST_TRIGGER]`**.
* Esta etiqueta indica que, cuando el usuario alcance ese nodo, el sistema debe hacer una solicitud y continuar el flujo por esa ruta.
Esto permite **esperar la respuesta de la IA** sin que la conversación quede bloqueada.
## Rutas condicionales con base en el output de la IA
Si tu IA devuelve un valor específico (por ejemplo, `"talkToAgent"` o `"fileUrl"`), puedes **crear ramificaciones en el flujo** para ofrecer respuestas personalizadas. Para hacerlo:
1. Envía estos valores como variables desde tu sistema.
2. Inserta un **bloque condicional** entre el `[REQUEST_TRIGGER]` y la respuesta.
3. Define las **diferentes rutas** que el usuario puede seguir según la variable recibida.
## Evita que los usuarios queden atascados
Para evitar que los usuarios se queden bloqueados dentro del flujo:
* Puedes configurar **flujos alternos** para hacer **seguimiento automático (follow-up)**.
* Esto puede servir para:
* Reintentar obtener una respuesta de la IA.
* Escalar la conversación a un humano después de cierto tiempo sin interacción.
## Flujo continuo con múltiples interacciones
Siempre que tu sistema necesite **volver a consultar a la IA**, asegúrate de que la **línea de retorno** hacia el bloque que procesa la respuesta **también incluya el webhook**.
# Llave de API y encabezados webhook
Source: https://help.treble.ai/es/api-reference/intro/api-key
Para interactuar con la API de Treble, necesitarás una llave de API. Esta llave te permitirá autenticar tus solicitudes a la API y acceder a los endpoints disponibles. Aprende a obtener tu llave de API en este artículo.
## ¿Qué es una llave de API?
Una llave de API es un identificador único que se utiliza para autenticar y autorizar las solicitudes a la API de Treble. Cada llave de API está asociada a una cuenta específica y tiene un conjunto de permisos asociados.
La llave de API que obtendrás es una llave global para toda la cuenta de Treble.
## ¿Cómo obtener una llave de API?
Para obtener una llave de API, debes seguir estos pasos:
1. Inicia sesión en tu cuenta de Treble
2. En la barra de navegación, haz clic en **Configuración** .
3. Luego haz clic en **Desarrolladores**
4. Encontrarás un campo llamado **Llave de API**
5. Copia la llave de API y guardala en un lugar seguro.
Ejemplo:
```
ak_S5BCOgOxrfENbkn-wH2gpPK3AM8ihLNmQg
```
Con esta llave, podrás autenticar tus solicitudes a la API de Treble. Para usarla, debes agregarla en el encabezado de la solicitud como un token de autenticación.
Ejemplo:
```
Authorization: ak_S5BCOgOxrfENbkn-wH2gpPK3AM8ihLNmQg
```
## Configuraciones Avanzadas
### Encabezados de Autenticación para webhooks
Si configuras algún webhook desde Treble hacia tu sistema de información, puedes agregar una lista de encabezados de autenticación para que la solicitud se pueda autenticar. Estos encabezados se agregarán a cada solicitud que se haga a tu webhook y se definen en formato JSON.
Ejemplo:
```json theme={null}
{
"Authorization": "Bearer 1234567890",
"X-API-Key": "1234567890"
}
```
De ahora en adelante, cada vez que hagas una solicitud a tu webhook, Treble agregará estos encabezados a la solicitud.
Para configurarlos ve a la sección de **Webhooks** y agrega los encabezados que necesites. Añádelos y luego haz clic en **Guardar**.
# Introducción
Source: https://help.treble.ai/es/api-reference/intro/intro
Esta es una introducción a la API de Treble. Aquí podrás encontrar información sobre los endpoints disponibles y cómo interactuar con ellos. La API de Treble agrega funcionalidades a la plataforma Treble para que puedas implementar casos de uso mas complejos.
## ¿Qué es la API de Treble?
La API de Treble es una interfaz de programación de aplicaciones que permite a los desarrolladores interactuar con la plataforma Treble. La API de Treble agrega funcionalidades a la plataforma Treble para que puedas implementar casos de uso mas complejos.
### ¿Qué es una API?
Una API (Interfaz de Programación de Aplicaciones) es un conjunto de reglas y protocolos que permite a diferentes aplicaciones comunicarse entre sí. Las APIs definen cómo los desarrolladores pueden interactuar con un servicio o plataforma para acceder a sus funcionalidades.
```mermaid theme={null}
graph TD;
A[Aplicación Cliente] -->|Solicita Datos| B[API];
B -->|Devuelve Respuesta| A;
```
### ¿Cómo se usa una API?
Las APIs se utilizan para enviar solicitudes a un servidor y recibir respuestas. Esto permite a las aplicaciones acceder a datos y servicios externos sin necesidad de conocer los detalles internos de cómo funcionan.
```mermaid theme={null}
sequenceDiagram
participant C as Cliente
participant S as Servidor
C->>S: Solicitud API
S-->>C: Respuesta API
```
### Importancia de las APIs en el contexto de Treble
* **Integración:** Las APIs permiten integrar Treble con otras aplicaciones y servicios, facilitando la automatización de procesos y el intercambio de datos.
* **Extensibilidad:** Los desarrolladores pueden extender las funcionalidades de Treble mediante el uso de APIs, creando soluciones personalizadas para sus necesidades específicas.
* **Eficiencia:** Las APIs permiten acceder a las funcionalidades de Treble de manera eficiente, reduciendo la necesidad de desarrollar soluciones desde cero.
### Ejemplo de Uso en Treble
En el contexto de Treble, las APIs son fundamentales para configurar webhooks que notifican a los desarrolladores sobre eventos importantes, como la lectura o entrega de mensajes. Esto permite a las empresas reaccionar en tiempo real a las interacciones de los usuarios.
En las siguientes secciones, podrás encontrar información sobre los endpoints disponibles, cómo configurar webhooks y cómo interactuar con ellos.
# Webhook de asignación de agente
Source: https://help.treble.ai/es/api-reference/webhooks/api-assignation/intro
Cuando usas el destino API del bloque de Métodos de transferencia, Treble llama a tu endpoint para que tu propio sistema decida qué agente debe recibir la conversación. Conoce aquí el contrato de la petición y la respuesta.
## ¿Cómo funciona?
Cuando una conversación llega a un bloque de **Métodos de transferencia** configurado con el destino **API**, Treble envía una petición `POST` al endpoint que configuraste, con la información del contacto y de la conversación. Tu servicio decide qué agente debe atenderla y lo devuelve en la respuesta. Treble asigna la conversación a ese agente.
Si tu servicio no responde a tiempo, o el agente que devuelves no puede recibir la conversación, Treble aplica el **método de respaldo** de tu empresa para que la conversación nunca quede sin asignar.
```mermaid theme={null}
sequenceDiagram
participant C as Cliente
participant T as Treble
participant S as Tu servidor
C->>T: La conversación llega al bloque de transferencia
T->>S: POST con el contexto del contacto
S->>S: Decide qué agente debe atender el chat
alt Agente resuelto
S->>T: 200 con agent_id o agent_email
T->>T: Asigna la conversación a ese agente
else Sin agente, error o timeout
S->>T: Código distinto de 200, timeout o agente inválido
T->>T: Aplica el método de respaldo
end
```
Este webhook **no se configura en el centro de webhooks**, sino dentro del propio bloque en el editor de conversaciones. Así, cada bloque puede llamar a un endpoint distinto.
Aprende a configurar la URL y la autenticación desde el editor de conversaciones.
## Autenticación
En el bloque puedes elegir entre dos opciones:
* **Sin autenticación** — Treble llama a tu endpoint sin credenciales.
* **Token / API Key** — Treble envía el token que configuraste en el header `Authorization`:
```
Authorization: Bearer TU_TOKEN
```
Usa siempre `https://` y configura un token. Así tu endpoint puede verificar que la llamada viene efectivamente de Treble.
## La petición que Treble envía
Treble hace un `POST` con un cuerpo JSON que contiene el contexto del contacto y de la conversación.
```json theme={null}
{
"company_id": 1234,
"survey_user_id": 567890,
"contact": {
"treble_id": "5215512345678",
"name": "Andrea Soto",
"country_code": "52",
"cellphone": "5512345678",
"business_scope_id": "1029384756",
"username": null
},
"crm_type": "salesforce",
"crm_objects": [
{ "entity": "Contact", "id": "0035f00000ABCDEqAO" },
{ "entity": "Account", "id": "0015f00000FGHIJqAO" }
],
"channel": {
"phone_number_id": "1234567890"
},
"metadata": {
"poll_id": 4321,
"node_id": "a1b2c3",
"tag": "Comercial",
"language": "es"
}
}
```
| Campo | Descripción |
| ------------------------- | --------------------------------------------------------------------------------------------------------------- |
| `company_id` | Identificador de tu empresa en Treble. |
| `survey_user_id` | Identificador de la sesión del contacto en la conversación. |
| `contact` | Información del contacto que está en la conversación. |
| `crm_type` | CRM con el que tu cuenta está integrada, por ejemplo `salesforce` o `hubspot`. Es `null` si no hay integración. |
| `crm_objects` | Registros del CRM asociados al contacto. |
| `channel.phone_number_id` | Identificador de la línea de WhatsApp que recibió la conversación. |
| `metadata` | Contexto del flujo y del bloque que originó la llamada: `poll_id`, `node_id`, `tag` e `language`. |
`cellphone` y `country_code` pueden llegar en `null` para contactos que solo existen como usuario de Meta. En ese caso, usa `business_scope_id` o `username` para identificar al usuario.
### Identificadores del CRM
Cuando tu cuenta tiene una integración de CRM, la petición incluye los identificadores del contacto en tu CRM para que puedas decidir con base en el registro; por ejemplo, consultar el propietario del registro y devolver a ese agente.
* **`crm_type`** — el CRM con el que tu cuenta está integrada. Es `null` si la cuenta no tiene integración.
* **`crm_objects`** — los registros del CRM asociados al contacto. Cada uno trae su **`entity`** (el tipo de objeto en el CRM, por ejemplo `Contact`, `Account` o `Lead`) y su **`id`** (el identificador del registro en tu CRM). Un contacto asociado a varios objetos de Salesforce trae una entrada por objeto; en otros CRMs hay una sola entrada. Un arreglo vacío significa que el contacto aún no está asociado a ningún registro.
## La respuesta que debes devolver
Responde con `200` y un cuerpo JSON que identifique al agente. Puedes hacerlo por **id** (recomendado) o por **email**:
```json Por id (recomendado) theme={null}
{
"agent_id": 4567
}
```
```json Por email theme={null}
{
"agent_email": "andrea.soto@tuempresa.com"
}
```
* **`agent_id`** — el identificador del agente en Treble. Es la opción recomendada: es un identificador estable que nunca cambia, incluso si el email del agente se actualiza.
* **`agent_email`** — el email del agente, exactamente como está registrado en Treble. También es soportado; si envías ambos campos, `agent_email` tiene precedencia.
El agente que devuelvas debe estar **activo**. Para conocer los agentes disponibles en tu cuenta —y los valores exactos de `id` y `email` que debes devolver— usa el endpoint de [obtener los agentes de tu empresa](/es/api-reference/endpoints/get-agents).
Tu endpoint debe responder en **menos de 10 segundos**. Si se excede, devuelve un código distinto de `200`, o devuelve un agente que no puede recibir la conversación, Treble aplica el método de respaldo configurado en la plataforma principal.
## Ejemplo de implementación
Un endpoint mínimo en Node.js que devuelve un agente según el contacto:
```javascript theme={null}
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhooks/on-agent-assignation', (req, res) => {
// Verifica que la llamada venga de Treble
if (req.header('Authorization') !== `Bearer ${process.env.TREBLE_TOKEN}`) {
return res.sendStatus(401);
}
const { contact, crm_type, crm_objects, metadata } = req.body;
// Tu lógica para elegir el agente: round robin, idioma,
// propietario en el CRM, segmento, etc.
const agentId = elegirAgente(contact, crm_objects, metadata);
// Devuelve el agente por id (recomendado) o por email
res.json({ agent_id: agentId });
});
app.listen(3000, () => {
console.log('Servidor escuchando en el puerto 3000');
});
```
## Siguientes pasos
Explora el esquema completo de la petición y la respuesta.
Consulta los agentes de tu cuenta para saber qué id o email devolver.
# Referencia del webhook de asignación
Source: https://help.treble.ai/es/api-reference/webhooks/api-assignation/reference
open-api-files/treble-api-es.json POST /webhooks/on-agent-assignation
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-agent-assignation). Treble lo llamará cuando una conversación llegue a un bloque de **Métodos de transferencia** configurado con el destino **API**, para que tu sistema decida qué agente debe recibir el chat.
La URL se configura en el propio bloque, dentro del editor de conversaciones. Si activas la autenticación por Token / API Key, Treble incluirá tu token en el header `Authorization` con el formato `Bearer TU_TOKEN`.
Debes responder en menos de 10 segundos. Si tu servidor no responde a tiempo, devuelve un código distinto de 200, o devuelve un agente que no puede recibir la conversación, Treble aplicará el método de respaldo configurado en la plataforma principal.
# Cuerpo de la solicitud Webhook de nodo de condición
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/condition-node-api
open-api-files/treble-api-es.json POST /webhooks/on-condition
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-condition). Treble llamará a este webhook cuando se evalúe un nodo condicional en la conversación. Debes configurar la URL de este webhook en el panel de administración de Treble.
También puedes configurar el webhook de respuesta para cada camino que salga de un nodo de condición.
Si lo haces, el cuerpo de la solicitud HTTP que se envía al endpoint configurado en Treble agregará el siguiente campo en el cuerpo de la solicitud:
```json theme={null}
{
"condition": {
"operator": "EQ",
"value": "18"
}
}
```
La condición es un objeto con una propiedad `operator` para mostrar qué acción se utilizó en la condición y un `value` para que la acción de la condición sea evaluada:
* Igual: EQ
* Diferente: DIFF
* Mayor que: GT
* Menor que: LT
* Mayor o igual que: GTEQ
* Menor o igual que: LTEQ
* Contiene: CONT
* No contiene: NCONT
* Ruta por defecto: DEFAULT
La respuesta también puede tener nuevas variables para la sesión que se pueden actualizar o crear para su uso posterior en la sesión. Es decir puedes, añadirlas en la respuesta del webhook como parte de las `user_session_keys`.
# Cuerpo de la solicitud Webhook de entrega de mensaje
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/delivered-api
open-api-files/treble-api-es.json POST /webhooks/on-delivered
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-delivered). Treble llamará a este webhook cuando un mensaje sea entregado al usuario. Debes configurar la URL de este webhook en el panel de administración de Treble.
# Webhooks de lectura y recepción de mensaje
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/delivered-read
Los webhooks de lectura y recepción de mensajes se activan cuando un usuario lee o recibe un mensaje. Aprende a configurarlos en este artículo.
## ¿Cómo funciona?
Por medio de Treble, que utiliza WhatsApp Business API, cuando un usuario lee o recibe un mensaje, podemos configurar un webhook para que se active cuando esto ocurra.
### Ejemplo caso de uso
Supongamos que eres una compañía de ventas de ropa y quieres saber cuando un cliente ha leído o recibido tu primer mensaje de marketing que habla sobre una promoción para tu nueva colección de ropa. A los primeros 100 clientes que se suscriban a tu newsletter, les ofrecerás un 10% de descuento en su primera compra.
Para esto, puedes configurar un webhook de lectura de mensaje en Treble. Cuando un cliente lea o reciba tu mensaje, el webhook se activará y enviará una solicitud HTTP a tu endpoint configurado en Treble.
## ¿Cómo configurar un webhook de lectura o recepción de mensaje?
Ingresa a Treble.ai por medio de la siguiente URL:
Ve a la sección de "Conversaciones" y haz click en el botón **"Crear Conversación".** También puedes configurar un webhook de lectura de mensaje en un flujo existente. Para esto, ve a la sección de "Flujos" y haz click en el botón **"Editar" ** de tu flujo.
Vamos a añadir el primer bloque de mensaje. Haz click en el botón **"Agregar bloque" **. En este caso, vamos a agregar una plantilla de mensaje (HSM) previamente creada y aprobada por Meta. Después vamos a conectar un bloque sencillo de mensaje con el bloque de HSM.
Ahora, vamos a hacer doble click en el bloque de mensaje, se desplegará un panel a la izquierda. En este panel, vamos a hacer click en el botón **"Webhook" **. Se desplegarán dos campos:
* **"Read"**: Aquí puedes agregar el endpoint al que quieres que se envíe la solicitud HTTP cuando este mensaje sea leído.
* **"Delivered"**: Aquí puedes agregar el endpoint al que quieres que se envíe la solicitud HTTP cuando este mensaje sea recibido.
Si estás en un flujo nuevo, haz click en el botón **"Publicar Conversación"** para guardar el flujo. Si estás en un flujo existente, haz click en el botón **"Guardar"** para guardar los cambios.
¡Listo! Ahora, cuando un cliente lea o reciba tu mensaje, el webhook se activará y enviará una solicitud HTTP a tu endpoint configurado en Treble.
## Siguiente paso
Para conocer el cuerpo de la solicitud HTTP que se envía cuando un cliente lee o recibe un mensaje, puedes visitar la siguiente sección:
Cuerpo de la solicitud Webhook de entrega de mensaje
Cuerpo de la solicitud Webhook de lectura de mensaje
## Tips
* Ten en cuenta que los webhooks de lectura y recepción de mensajes se activan cuando un cliente lee o recibe un mensaje y solo aplican para el mensaje que configuraste. Si quieres que se active en otros mensajes, debes configurar un webhook para cada mensaje.
* El webhook de lectura de mensaje puede no activarse si el usuario de WhatsApp tiene configurado el modo de privacidad de lectura.
# Webhook de respuesta de mensaje
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/message-response
Los webhook de respuesta de mensaje se activan cuando un usuario responde a un mensaje. Aprende a configurarlos en este artículo.
## ¿Cómo funciona?
Cuando un usuario responde a un mensaje, podemos configurar un webhook para que se active y se envíe una solicitud HTTP a tu endpoint configurado en Treble. Este webhook es uno de los mas importantes para implementar casos de uso complejos, como la automatización de procesos o la integración con otras aplicaciones.
Por ejemplo, puedes configurar un webhook para capturar la respuesta de un cliente cuando se le pide su número de identificación. Treble enviará una solicitud HTTP a tu endpoint configurado en Treble con la respuesta del cliente la cual puedes procesar en tu aplicación. Posteriormente, puedes incluso devolver información a la conversación (flujo) de Treble para mostrar información dinámica obtenida por tu servidor, o encaminar la conversación por otro camino.
### Diagrama de flujo de webhook de respuesta de mensaje
En este ejemplo, el cliente responde a un mensaje de WhatsApp con su número de identificación. Treble envía una solicitud HTTP a tu endpoint configurado en Treble con la respuesta del cliente con el número de identificación. Tu servidor la procesa y devuelve información a Treble para continuar la conversación.
```mermaid theme={null}
sequenceDiagram
participant C as Cliente
participant W as Webhook
participant S as Servidor
participant T as Treble
C->>T: Responde mensaje de WhatsApp
T->>W: Webhook activado con identificacion: {respuesta_cliente}
W->>S: Envía solicitud con identificacion
S->>S: Procesa el webhook
alt Usuario existe
S->>W: Respuesta con resp_servidor: usuario autenticado
else Usuario no existe
S->>W: Respuesta con resp_servidor: usuario no autenticado
end
W->>T: Envía datos de regreso a Treble
alt resp_servidor es usuario autenticado
T->>T: Continúa por el camino de usuario autenticado
else resp_servidor es usuario no autenticado
T->>T: Continúa por otro camino
end
```
## ¿Cómo configurar un webhook de respuesta de mensaje?
Ingresa a Treble.ai por medio de la siguiente URL:
Ve a la sección de "Conversaciones" y haz click en el botón **"Crear Conversación".** También puedes configurar un webhook de lectura de mensaje en un flujo existente. Para esto, ve a la sección de "Flujos" y haz click en el botón **"Editar" ** de tu flujo.
Vamos a añadir el primer bloque de mensaje. Haz click en el botón **"Agregar bloque" **. En este caso, vamos a agregar una plantilla de mensaje (HSM) previamente creada y aprobada por Meta. Después vamos a conectar un bloque sencillo de mensaje con el bloque de HSM. Aqui vamos a preguntar por el número de identificación del cliente.
Ahora, vamos a hacer doble click en la flecha que sale del bloque de mensaje y conecta con el bloque de respuesta. Se desplegará un campo de texto en la parte superior. En este campo, vamos a agregar el endpoint al que quieres que se envíe la solicitud HTTP cuando este mensaje sea leído.
Es necesario especificar la variable para capturar la respuesta del cliente. Vamos a hacer doble click en el bloque de pregunta donde estamos pidiendo el número de identificación. En el panel que se despliega a la izquierda, vamos a hacer click en la opción **"Guardar respuesta como variable"**. Se van a desplegar dos campos:
* **"Tipo de respuesta"**: Aquí puedes escoger el tipo de respuesta que quieres capturar. En este caso, vamos a escoger **"Número"**.
* **"Nombre de la variable"**: Aquí puedes agregar el nombre de la variable que quieres que se guarde. En este caso, vamos a agregar `id_cliente`.
El uso de variables en Treble es un concepto clave para la automatización de procesos. Puedes leer más sobre ellas en:
Aprende más sobre variables en Treble.
Para que el webhook se active, debes guardar los cambios. Si estás en un flujo nuevo, haz click en el botón **"Publicar Conversación"** para guardar el flujo. Si estás en un flujo existente, haz click en el botón **"Guardar"** para guardar los cambios.
¡Listo! Ahora, cuando un responda a tu mensaje, el webhook se activará y enviará una solicitud HTTP a tu endpoint configurado en Treble. El cuerpo de la solicitud va a contener información del evento de respuesta.
Aprende más sobre el cuerpo de webhook de respuesta de mensaje.
## Tutorial Avanzado - Respuesta de tu servidor
En el paso a paso anterior, vimos cómo configurar un webhook de respuesta de mensaje en Treble. Ahora, vamos a ver cómo procesar la respuesta del cliente en tu servidor. Para esto, es necesario que tu servidor tenga un endpoint público al que se pueda enviar la solicitud HTTP.
### Paso a Paso
1. **Configura tu servidor:**
Asegúrate de que tu servidor esté configurado para recibir solicitudes HTTP. Puedes usar un framework como Express en Node.js para facilitar este proceso.
2. **Crea un endpoint para el webhook:**
Define un endpoint en tu servidor que pueda recibir las solicitudes del webhook.
3. **Procesa la solicitud:**
Extrae la información relevante de la solicitud y realiza las acciones necesarias, como verificar si el usuario existe.
4. **Envía una respuesta a Treble:**
Devuelve una respuesta a Treble con la información procesada, como el estado de autenticación del usuario. La respuesta debe ser un JSON con el siguiente formato:
```json theme={null}
{
"user_session_keys":[
{
"key":"servidor_usuario_valid",
"value":"si"
}
]
}
```
Los `user_session_keys` es un arreglo de objetos que contiene la clave y el valor de la respuesta. Para este ejemplo, la clave debe ser `servidor_usuario_valid` y el valor debe ser `si` si el usuario existe o `no` si no existe. Sin embargo, puedes enviar de regreso a Treble cualquier información que necesites para continuar la conversación. Dicha respuesta puede contener mas variables que se puedan usar en el flujo.
Ejemplo:
```json theme={null}
{
"user_session_keys":[
{
"key":"nombre_usuario",
"value":"Juan Perez"
},
{
"key":"fecha_ultima_compra",
"value":"2025-01-01"
}
]
}
```
### Ejemplo de Código
Aquí tienes un ejemplo básico de cómo podrías implementar esto en Node.js:
```javascript theme={null}
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhook', (req, res) => {
// Extrae la identificación del usuario de los user_session_keys
const identificacion = req.body.user_session_keys.find(key => key.key === 'id_cliente')?.value;
// Simula la verificación del usuario
const usuarioExiste = verificarUsuario(identificacion);
// Prepara la respuesta para Treble
const resp_servidor = usuarioExiste ? 'si' : 'no';
// Envía la respuesta de vuelta a Treble con la estructura correcta
res.json({
user_session_keys: [
{
key: "servidor_usuario_valid",
value: resp_servidor
}
]
});
});
function verificarUsuario(identificacion) {
// Lógica para verificar si el usuario existe
// Aquí puedes consultar una base de datos o un servicio externo
return identificacion === '12345'; // Ejemplo de verificación
}
app.listen(3000, () => {
console.log('Servidor escuchando en el puerto 3000');
});
```
5. De regreso en tu conversación (flujo) en Treble, conectamos un bloque de condiciones para evaluar la respuesta del servidor. Nota como la variable `servidor_usuario_valid` es una variable de sesión que se guarda en el flujo y es la respuesta que se envía al servidor. El bloque de condiciones es un bloque de tipo "Si" y evalua si la variable `servidor_usuario_valid` es igual a `si`. Si es así, se continúa por el camino de usuario autenticado. Si no, se continúa por otro camino.
¡Listo! Hemos configurado un webhook de respuesta de mensaje en Treble. Ahora, cuando un responda a tu mensaje, el webhook se activará y enviará una solicitud HTTP a tu endpoint configurado en Treble con la respuesta del cliente. Tu servidor la procesa y devuelve información a Treble para continuar la conversación.
## Ten en cuenta
* Debes configurar el webhook de respuesta para cada respuesta (flecha ) que sale de un bloque de mensaje. Si lo configuras en una única respuesta o la primera, únicamente se activará para la primera respuesta.
En la siguiente imagen, se ve cómo debes configurar el webhook de respuesta para cada una de las 3 respuestas que salen de un bloque de mensaje.
La respuesta de tu servidor al webhook no puede durar mas de 10 segundos. Si tu servidor tarda mas de 10 segundos en responder, el webhook se marcará como timeout y se continuará la conversación del flujo en Treble. Puedes extender el tiempo de respuesta con la opción de `[REQUEST_TRIGGER]`. Para más información, puedes leer el artículo: Detener conversación de Treble y esperar respuesta de tu servidor.
# Cuerpo de la solicitud Webhook de respuesta de mensaje
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/message-response-api
open-api-files/treble-api-es.json POST /webhooks/on-response
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-response). Treble llamará a este webhook cuando un usuario responda a una pregunta en la conversación. Debes configurar la URL de este webhook en el panel de administración de Treble.
# Webhook de opt-out
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/opt-out
Los webhook de opt-out se activan cuando un usuario opta por no recibir más mensajes. Aprende a configurarlos en este artículo.
## ¿Cómo funciona?
Los webhook de opt-out se activan cuando un usuario opta por no recibir más mensajes. Esto se puede configurar para cualquier mensaje dentro de alguno de tus flujos. Sin embargo, recomendamos que si piensas configurar la opción de opt-out, lo hagas generalmente en el primer mensaje de tu flujo. Esto es para que el usuario tenga la opción de opt-out antes de que se le envíe cualquier otro mensaje futuro y ayuda a mantener la calidad de tu línea de WhatsApp.
## ¿Qué significa opt-out?
Opt-out es el proceso mediante el cual un usuario decide no recibir más mensajes de una fuente específica. En el contexto de los webhooks, esto implica que cuando un usuario elige optar por no recibir más mensajes, se activa un webhook que notifica a tu sistema sobre esta decisión. Esto permite que tu aplicación gestione adecuadamente las preferencias de comunicación del usuario, asegurando que no se le envíen mensajes no deseados en el futuro. Implementar un mecanismo de opt-out es crucial para respetar la privacidad y las preferencias de los usuarios, y para cumplir con las normativas de comunicación de Meta.
Cuando activas la opción de opt-out en un flujo, y el usuario responde a una pregunta dirigiendose por la opción de opt-out, Treble va a guardar el número de teléfono del usuario en una lista interna donde están todos los números de teléfono que han optado por no recibir más mensajes.
### ¿Dónde encuentro la lista de números de teléfono que han optado por no recibir más mensajes?
Puedes encontrar la lista de números de teléfono que han optado por no recibir más mensajes en la sección de **"Usuarios bloqueados"** dentro de **"Configuración"** en tu cuenta en Treble.
Para hacerlo, sigue estos pasos:
1. Inicia sesión en tu cuenta en Treble ingresando a
2. Ve a la sección de **"Configuración"** en tu cuenta en Treble.
3. Ve a la sección de **"Usuarios bloqueados"**.
4. En la vista, podrás escoger entre descargar la lista de números que eligieron la opción de opt-out o ver la lista de números que tu has decidido bloquear.
5. Haz clic en el botón **"Descargar"** para descargar la lista de números que están bloqueados.
6. Adicionalmente, puedes agregar números individuales a la lista de usuarios bloqueados. Para hacerlo, ingresa el número de teléfono en el campo de texto: **Bloquear Usuarios** y haz clic en el botón **"Bloquear"**.
### ¿Cómo puedo desbloquear un número de teléfono?
Para desbloquear uno o varios número de teléfono, es necesario que te contactes con nuestro equipo de soporte.
Contacta a nuestro equipo de soporte.
## Configuración de webhook de opt-out
Ingresa a Treble.ai por medio de la siguiente URL:
Ve a la sección de "Conversaciones" y haz click en el botón **"Crear Conversación".** También puedes configurar un webhook de opt-out en un flujo existente. Para esto, ve a la sección de "Flujos" y haz click en el botón **"Editar" ** de tu flujo.
Añade bloques de mensaje a tu flujo o edita el flujo existente. Haz click en el botón **"Agregar bloque" **.
Ahora, vamos a hacer doble click en el bloque de mensaje, se desplegará un panel a la izquierda. En este panel, vamos a hacer scroll hasta la sección de **"Respuestas como opción de exclusión"** y haz click en el switch de la opción que quieres configurar para excluir a los usuarios que opten por no recibir más mensajes.
Acepta los términos y condiciones del modal que se despliega y luego puedes escribir la URL de tu endpoint en el campo de texto **"URL de webhook"**.
¡Listo! Ahora, cuando un usuario opta por no recibir más mensajes, el webhook se activará y enviará una solicitud HTTP a tu endpoint configurado en Treble.
## Ten en cuenta
* Si configuras una opción de opt-out en tu flujo y estas haciendo pruebas con tu número de teléfono, es posible que tu propio número de teléfono se agregue a la lista de usuarios bloqueados. Si esto sucede, no podrás enviar conversaciones a tu número de teléfono. Para desbloquear tu número de teléfono, puedes contactar a nuestro equipo de soporte.
# Cuerpo de la solicitud Webhook de opt-out
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/opt-out-api
open-api-files/treble-api-es.json POST /webhooks/on-optout
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-optout). Treble llamará a este webhook cuando un usuario decida darse de baja o salir de la conversación. Debes configurar la URL de este webhook en el panel de administración de Treble.
# Cuerpo de la solicitud Webhook de lectura de mensaje
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/read-api
open-api-files/treble-api-es.json POST /webhooks/on-read
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-read). Treble llamará a este webhook cuando un mensaje sea leído por el usuario. Debes configurar la URL de este webhook en el panel de administración de Treble.
# Detener conversación de Treble y esperar respuesta de tu servidor
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/request-trigger
Normalmente, Treble espera que la respuesta de tu servidor a un webhook sea menos de 10 segundos. Si necesitas más tiempo, puedes detener la conversación de Treble y esperar la respuesta de tu servidor con la opción de `[REQUEST_TRIGGER]`. Aprende a configurarla en este artículo.
## Request Trigger
Todo webhook de Treble espera una respuesta de tu servidor en menos de 10 segundos. Si el tiempo se excede, el webhook se marcará como timeout y se continuará la conversación del flujo en Treble.
Sin embargo, hay veces donde la conversación de WhatsApp de Treble debe esperar a la respuesta de tu servidor. Por ejemplo, cuando un cliente envía una foto de su identidad nacional para validar su cuenta y tu servidor debe procesar la imagen y validarla. Es posible que esto tome más de 10 segundos.
Para esto, puedes detener la conversación de Treble y esperar la respuesta de tu servidor con la opción de `[REQUEST_TRIGGER]`. Con la opción de `[REQUEST_TRIGGER]`, Treble esperará a que tu servidor llame al endpoint de `POST /session/{session_external_id}/update` para continuar la conversación.
```mermaid theme={null}
sequenceDiagram
participant Usuario
participant Treble
participant Servidor
Usuario->>Treble: Envía mensaje (ej. foto de identidad)
Treble->>Servidor: Envía webhook con session_id
note right of Treble: Espera respuesta del servidor
Servidor-->>Treble: Procesa y valida la información
Servidor->>Treble: Llama a POST /session/{session_external_id}/update
Treble->>Usuario: Continúa la conversación
```
## ¿Cómo configurar un request trigger?
La configuración de un request trigger consta de dos partes:
1. La configuración del webhook que es efectuada en el camino que conecta al nodo (bloque de mensaje) donde quieres detener la conversación.
2. La configuración del bloque de mensaje que tiene una única opción de respuesta la cual es el texto: `[REQUEST_TRIGGER]`.
En la siguiente imagen, se ve cómo debes configurar tu flujo de mensaje para que se detenga y se espere la respuesta de tu servidor.
Ten en cuenta que el bloque de mensaje que debes usar para detener la conversación y esperar la respuesta de tu servidor debe ser un bloque de mensaje no-interactivo. Es decir, escoge la opción **Mensaje con opciones** y no **Botones Interactivos**.
Una vez hecho esto, cuando tu usuario pase por el camino que conecta al bloque de mensaje con el texto `[REQUEST_TRIGGER]`, Treble detendrá la conversación y esperará la respuesta de tu servidor.
### ¿Cómo continuar la conversación?
Para continuar la conversación, debes obtener el `session_id` de la sesión de Treble que viene como parte del cuerpo de la solicitud del webhook.
Por ejemplo:
```json theme={null}
{
"country_code": "+57",
"cellphone":"3161234567",
"session_id" : "abcsderfwer3252432423-1324325235",
"conversation_id": 1234,
"question": {
"type": "open",
"text": "Hello world"
}
"timeout_at": "2021-10-07 08:53:22.572123",
"user_session_keys":[]
}
```
Aqui debemos extraer el `session_id` y usarlo para llamar al endpoint de `POST /session/{session_external_id}/update`.
Actualizar una sesión para continuar la conversación.
Recuerda que al hacer la llamada al endpoint de `POST /session/{session_external_id}/update`, puedes tambien incluir en el cuerpo de la solicitud el `user_session_keys`, es decir, variables de sesión que pueden ser usadas para continuar la conversación.
¡Listo! Has logrado configurar un request trigger en tu flujo de mensaje.
# Cuerpo de la solicitud Webhook de timeout (flujo alterno)
Source: https://help.treble.ai/es/api-reference/webhooks/conversation-editor/timeout-api
open-api-files/treble-api-es.json POST /webhooks/on-timeout
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/webhooks/on-timeout). Treble llamará a este webhook cuando ocurra un timeout en la conversación (el usuario no responde dentro del tiempo establecido). Debes configurar la URL de este webhook en el panel de administración de Treble.
También puedes configurar el webhook de respuesta para el camino que salga de un nodo en el caso de timeout, tambien conocido como flujo alterno.
Si lo haces, el cuerpo de la solicitud HTTP que se envía al endpoint configurado en Treble agregará el siguiente campo en el cuerpo de la solicitud:
```json theme={null}
{
"timeout_at": "2021-10-07 08:53:22.572123"
}
```
La respuesta también puede tener nuevas variables para la sesión que se pueden actualizar o crear para su uso posterior en la sesión. Es decir puedes, añadirlas en la respuesta del webhook como parte de las `user_session_keys`.
# Introducción a los webhooks
Source: https://help.treble.ai/es/api-reference/webhooks/intro
Los webhooks son una forma de recibir notificaciones en tiempo real sobre eventos específicos en la plataforma Treble. Aprende a configurar y usar webhooks para recibir notificaciones en tiempo real en este artículo.
## ¿Qué son los webhooks?
Los webhooks son una forma de recibir notificaciones en tiempo real sobre eventos específicos en la plataforma Treble. Treble te permite configurar webhooks que pueden ser usados para múltiples propósitos, como notificaciones de eventos de conversaciones, actualizaciones de sesiones, etc.
Treble utiliza el sistema de realizar un llamado a tu endpoint para poderte notificar de los eventos que se están sucediendo en la plataforma.
### ¿Cómo funcionan los webhooks?
Cuando ocurre un evento en Treble, se envía una solicitud HTTP POST a la URL del webhook configurado. Esta solicitud contiene información sobre el evento, que tu servidor puede procesar para realizar acciones específicas, como actualizar una base de datos o enviar una notificación.
```mermaid theme={null}
sequenceDiagram
participant T as Treble
participant W as Webhook
participant C as Cliente
T->>W: Evento ocurre
W->>C: Envía solicitud HTTP
C->>W: Procesa la solicitud
W->>T: Envía respuesta HTTP
```
### Beneficios de usar webhooks
* **Eficiencia en tiempo real:** Recibe notificaciones instantáneas sobre eventos importantes sin necesidad de consultar constantemente la API.
* **Automatización:** Permite automatizar flujos de trabajo al desencadenar acciones automáticamente en respuesta a eventos.
* **Flexibilidad:** Se pueden configurar para una variedad de eventos y personalizar según las necesidades del negocio.
### Ejemplos de uso
* **Notificaciones de mensajes:** Recibir alertas cuando un mensaje es leído o entregado.
* **Actualizaciones de estado:** Monitorear cambios en el estado de una conversación o sesión.
* **Integraciones:** Conectar Treble con otras aplicaciones o servicios para sincronizar datos o iniciar procesos.
Con esta información adicional, tendrás una comprensión más completa de cómo los webhooks pueden ser utilizados para mejorar la interacción con la plataforma Treble y automatizar procesos en tu sistema.
## ¿Qué tipo de webhooks existen en Treble?
1. **Webhook de lectura de mensaje:** Este webhook se activa cuando un usuario lee un mensaje en una conversación.
2. **Webhook de entrega de mensaje:** Este webhook se activa cuando un mensaje es enviado a un usuario.
3. **Webhook de opt-out:** Este webhook se activa cuando un usuario opta por no recibir más mensajes.
4. **Webhook de respuesta de un mensaje:** Utilizado para notificar cuando se reciba una respuesta de un mensaje específico de uno de tus flujos de conversación.
5. **Webhook de cierre de conversación:** Este webhook se activa cuando una conversación es cerrada.
6. **Webhook cambio de estado de HSM:** Este webhook se activa cuando un HSM cambia de estado.
7. **Webhook de asignación de agente:** Este webhook se activa cuando una conversación llega a un bloque de transferencia configurado con el destino **API**, para que tu sistema decida qué agente la recibe. A diferencia de los demás, Treble **usa tu respuesta** para asignar la conversación.
Algunos de los webhooks mencionados anteriormente se deben configurar dentro de cada flujo específico de una conversación, mientas que otros actuan de forma global en la plataforma Treble. Te mostramos una tabla para entender cuales son los webhooks que se pueden configurar en cada caso.
| Webhook | Configurado en |
| ---------------------------------- | ------------------------------------- |
| Webhook de lectura de mensaje | Flujo |
| Webhook de entrega de mensaje | Flujo |
| Webhook de respuesta de un mensaje | Flujo |
| Webhook de opt-out | Flujo |
| Webhook de cierre de conversación | Globalmente en Treble |
| Webhook cambio de estado de HSM | Globalmente en Treble |
| Webhook de asignación de agente | Flujo (en el bloque de transferencia) |
## ¿Qué debo tener en cuenta para configurar un webhook?
Debes tener conocimiento de cómo recibir y procesar solicitudes HTTP. Adicionalmente, debes tener un servidor o servicio que pueda recibir y procesar estas solicitudes.
### Seguridad
* **Autenticación:** Asegúrate de que las solicitudes provienen de una fuente confiable. Puedes usar tokens de autenticación o claves secretas para verificar la autenticidad de las solicitudes.
* **Cifrado:** Utiliza HTTPS para cifrar las solicitudes y proteger los datos en tránsito.
### Validación de Datos
* **Verifica los datos recibidos:** Asegúrate de que los datos en la solicitud sean válidos y completos antes de procesarlos.
* **Manejo de errores:** Implementa un manejo de errores robusto para responder adecuadamente a solicitudes malformadas o no autorizadas.
### Ejemplo de Código
Aquí tienes un ejemplo básico de cómo podrías configurar un endpoint para recibir un webhook en Node.js:
```javascript theme={null}
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhook', (req, res) => {
const { event, data } = req.body;
// Verifica la autenticidad de la solicitud
if (!isValidRequest(req)) {
return res.status(401).send('Unauthorized');
}
// Procesa el evento
switch (event) {
case 'message_read':
handleMessageRead(data);
break;
// Maneja otros eventos
default:
console.log('Evento no reconocido:', event);
}
res.status(200).send('Evento procesado');
});
function isValidRequest(req) {
// Implementa la lógica de validación
return true;
}
function handleMessageRead(data) {
console.log('Mensaje leído:', data);
}
app.listen(3000, () => {
console.log('Servidor escuchando en el puerto 3000');
});
```
### Pruebas
* **Prueba tu endpoint:** Usa herramientas como Postman o curl para enviar solicitudes de prueba y asegurarte de que tu servidor responde correctamente.
* **Simula diferentes escenarios:** Asegúrate de que tu sistema maneje adecuadamente diferentes tipos de eventos y errores.
Con estos consejos y ejemplos, estarás mejor preparado para configurar y manejar webhooks de manera efectiva.
## Siguientes pasos
En los siguientes artículos te mostramos como configurar cada uno de los webhooks mencionados anteriormente.
# Ejemplos de las solicitudes Webhook
Source: https://help.treble.ai/es/api-reference/webhooks/webhook-center/api-example
open-api-files/treble-api-es.json POST /treble-webhooks
Este endpoint debe ser implementado en TU servidor (por ejemplo: https://tudominio.com/treble-webhooks). Treble llamará a este webhook para diferentes tipos de eventos. Debes configurar la URL de este webhook en el panel de administración de Treble.
# Webhook de cierre de conversación
Source: https://help.treble.ai/es/api-reference/webhooks/webhook-center/conversation-closed
El webhook de cierre de conversación se activa cuando un cliente cierra una conversación. Aprende a configurarlos en este artículo.
## ¿Cuándo ocurre un cierre de conversación en Treble?
En Treble los flujos de conversación (conversaciones) se "cierran" cuando ocurre alguna de las siguientes acciones:
### El cliente responde a cualquier bloque de mensaje final.
Imagina que las conversaciones en Treble son como un árbol con muchas ramas. Cada vez que un cliente toma una decisión, es como elegir una rama para seguir. Al final de cada rama, hay una hoja. Cuando el cliente llega a una hoja y responde al último mensaje, la conversación se cierra. Es como si el cliente hubiera llegado al final de su camino en el árbol, habiendo explorado todas las opciones disponibles en esa dirección.
Por ejemplo, en la siguiente imagen, el cliente cierra la conversación al responder a cualquiera de los bloques de mensaje #1, #2, #4 o #5. Pero no al responder a los bloques de mensaje #3, porque este mensaje no es final.
**¿Es decir que para que se cierre una conversación, el cliente debe responder a un bloque de mensaje final, aun si ese último mensaje puede ser un mensaje de despedida o un mensaje de agradecimiento?**
Sí, para que se cierre una conversación, el cliente debe responder a un bloque de mensaje final, Treble no puede inferir que el cliente quiere cerrar la conversación.
### Tienes configurado el cierre automático de conversaciones después de X minutos de haber iniciado la conversación.
En Treble existen dos conceptos similares pero distintos:
* **Duración de la sesión de WhatsApp:** Es el tiempo que transcurre desde que el cliente inicia una conversación con tu línea de WhatsApp Business API y es una ventana de 24 horas que se vence cuando tu cliente deja de interactuar con tu línea.
* **Sesión de Treble:** Es la forma en la cual Treble sabe qué conversación es la que está interactuando con el cliente. Por defecto, una sesión de Treble no expira, es decir, puede que tu cliente deje de interactuar con tu línea de WhatsApp Business API y eso haga que la sesión de WhatsApp expire, pero la sesión de Treble no. Esto le permite a tu cliente volver a interactuar con la misma conversación aun si vuelve a conectarte unos días después.
Sin embargo, puede que quieras que una conversación se cierre automáticamente después de X minutos de haber iniciado la conversación. Para esto, puedes configurar el cierre automático de conversaciones en la sección de configuración de tu cuenta.
#### Configurar el cierre automático de conversaciones
Para configurar el cierre automático de conversaciones, debes seguir estos pasos:
1. Ingresa a tu cuenta en Treble, por medio la dirección
2. Ve a la sección de **Configuración ** en el menú de navegación.
3. Luego, has click en **Conversaciones ** en el menú de navegación.
4. Dirígete a la opción de **Desactivar despues de tiempo de inactividad** y configura el tiempo en minutos.
5. ¡Listo! Ahora, cuando una conversación no tenga actividad por X minutos, se cerrará automáticamente.
## Webhook de cierre de conversación
Ahora que ya sabes cuándo ocurre un cierre de conversación en Treble, te presentamos el webhook de cierre de conversación. El webhook se activará cuando ocurra un cierre de conversación en Treble.
### ¿Cómo configurar el webhook de cierre de conversación?
Para configurar el webhook de cierre de conversación, debes seguir estos pasos:
1. Ingresa a Treble.ai por medio de la siguiente URL:
2. Ve a la sección de **Configuración** y selecciona **Webhooks**.
3. Podrás ver un campo de **URL del webhook**. Este es el endpoint al que se enviará la solicitud HTTP.
4. Ingresa la URL de tu webhook en el campo **URL del webhook**.
5. Haz clic en el botón de **Actualización de cierre de sesión** para habilitar este tipo de notificaciones
6. Haz clic en **Guardar**.
7. ¡Listo! Ahora, cuando ocurra un cierre de conversación en Treble, se activará el webhook.
# Webhook de falla en despliegue
Source: https://help.treble.ai/es/api-reference/webhooks/webhook-center/deployment-failure
El webhook de falla en despliegue se activa cuando ocurre un error durante el proceso de despliegue de una conversación. Aprende a configurarlo y manejarlo en este artículo.
## Fallas en despliegues
Los despliegues pueden fallar por diferentes razones. Cuando esto ocurre, es importante estar informado para poder tomar las acciones correctivas necesarias.
¿Por qué pueden fallar los despliegues?
* **FAILURE**: Problema con el despliegue después de 3 reintentos fallidos
* **FAILURE\_BY\_HUMAN\_HANDOVER**: El usuario se encuentra hablando con un agente
* **REVOKED**: El despliegue fue cancelado
* **INVALID\_PHONE**: El celular no es un celular válido o no tiene WhatsApp
* **FAILURE\_BY\_RATE\_LIMIT**: Falló porque el mensaje superaría el límite permitido por WhatsApp
* **COMPANY\_RATE\_LIMIT**: Superó el límite de sesiones que fue solicitada por la empresa
* **FAILURE\_BY\_TIER\_CAPACITY**: No hay una línea disponible y con capacidad para hacer el despliegue
* **MISSING\_PARAMETER**: Faltó una variable en el HSM por ser rellenada
* **PARAMETER\_MISMATCH**: El número de variables enviadas no coincide con el número de variables del HSM
* **FAILURE\_BY\_BLOCKED\_CONTACT**: El contacto ha sido bloqueado por la empresa
* **FAILURE\_BY\_OPTOUT\_CONTACT**: El contacto ha optado por no recibir más comunicaciones de la empresa
* **INVALID\_POLL**: Se intentó enviar una conversación eliminada o desactivada
* **CHARACTER\_LIMIT\_HEADER**: El encabezado de la plantilla HSM excede límite de caracteres permitido por WhatsApp
* **CHARACTER\_LIMIT\_BODY**: El cuerpo de la plantilla HSM excede el límite de caracteres permitido por WhatsApp
* **FAILURE\_BY\_DISABLED\_HSM**: La plantilla HSM enviada ha sido deshabilitada por Meta
* **FAILURE\_BY\_SPAM\_RATE\_LIMIT**: WhatsApp restringió la linea de WhatsApp por hacer spam y no puede hacer más despliegues en el momento
* **FAILURE\_BY\_EXPERIMENT\_NUMBER**: WhatsApp está utilizando ese número para experimentos internos y no se pudo realizar el despliegue
* **FAILURE\_BY\_UNABLE\_TO\_CONTACT**: No se pudo realizar el despliegue porque el usuario no está en capacidad de recibir el mensaje (No tiene WhatsApp, tiene una versión obsoleta, etc.)
El webhook de falla en despliegue te permite estar al pendiente de estos eventos y tomar las acciones necesarias de forma inmediata.
## ¿Cómo configurar un webhook de falla en despliegue?
Para configurar un webhook de falla en despliegue, debes seguir los siguientes pasos:
1. Ingresa a Treble.ai por medio de la siguiente URL:
2. Ve a la sección de **Configuración** y selecciona **Webhooks**.
3. Podrás ver un campo de **URL del webhook**. Este es el endpoint al que se enviará la solicitud HTTP cuando ocurra una falla en el despliegue.
4. Ingresa la URL de tu webhook en el campo **URL del webhook**.
5. Haz clic en el botón de **Fallo de despliegue** para habilitar este tipo de notificaciones.
6. Haz clic en **Guardar**.
7. ¡Listo! Ahora, cuando ocurra una falla en un despliegue en Treble, se activará el webhook.
# Webhook de cambio de estado de Plantilla HSM
Source: https://help.treble.ai/es/api-reference/webhooks/webhook-center/hsm-change-state
El webhook de cambio de estado de Plantilla HSM se activa cuando Meta cambia el estado de una Plantilla HSM. Aprende a configurarlos en este artículo.
## Antes de empezar
Antes de empezar, asegúrate de que tengas conocimiento de lo que es una Plantilla HSM. Si no lo tienes claro, puedes leer el artículo:
Aprende todo sobre las Plantillas HSM. Aprende a crear una Plantilla HSM y a utilizarla en un flujo.
## Cambio de estado de Plantilla HSM
Las plantillas HSM tienen estados diferentes. Conocemos que cuando creamos una plantilla, debemos enviarla a aprobar en Meta. En este caso la plantilla queda en estado de **En Revisión**. Cuando Meta aprueba la plantilla, esta queda en estado de **Activa**. Si Meta rechaza la plantilla, esta quedará en estado de **Rechazada**.
¿Por qué pueden llegar a cambiar estos elementos de una Plantilla HSM?
* Meta detecta que tus clientes están marcando tus conversaciones como spam, lo cual genera que Meta pueda pausar o desactivar tu plantilla.
* Hiciste una edición en la plantilla y Meta la marca como **En Revisión**.
* Meta te aprueba una plantilla previamente desabilitada o pausada para que pueda ser utilizada nuevamente.
Hay muchos escenarios que pueden causar estos cambios. Por medio de la configuración del webhook, puedes estar al pendiente de estos cambios y tomar las acciones necesarias.
## ¿Cómo configurar un webhook de cambio de estado de Plantilla HSM?
Para configurar un webhook de cambio de estado de Plantilla HSM, debes seguir los siguientes pasos:
1. Ingresa a Treble.ai por medio de la siguiente URL:
2. Ve a la sección de **Configuración** y selecciona **Webhooks**.
3. Podrás ver un campo de **URL del webhook**. Este es el endpoint al que se enviará la solicitud HTTP cuando ocurra un cambio de estado de una Plantilla HSM.
4. Ingresa la URL de tu webhook en el campo **URL del webhook**.
5. Haz clic en **Guardar**.
6. Ingresa a Treble.ai por medio de la siguiente URL:
7. Ve a la sección de **Configuración** y selecciona **Webhooks**.
8. Podrás ver un campo de **URL del webhook**. Este es el endpoint al que se enviará la solicitud HTTP.
9. Ingresa la URL de tu webhook en el campo **URL del webhook**.
10. Haz clic en el botón de **Actualización del estado del HSM** para habilitar este tipo de notificaciones
11. Haz clic en **Guardar**.
12. ¡Listo! Ahora, cuando ocurra un de cambio de estado de una Plantilla HSM en Treble, se activará el webhook.
# Introducción a los webhooks
Source: https://help.treble.ai/es/api-reference/webhooks/webhook-center/intro
Los webhooks en Treble te permiten recibir notificaciones en tiempo real sobre eventos importantes de la plataforma, como cambios de estado de HSM, cierre de sesiones o fallos en despliegues.
## ¿Qué es el centro de webhooks?
El centro de webhooks de Treble es el lugar donde puedes configurar las URLs de tus endpoints para recibir notificaciones en tiempo real sobre eventos relevantes de la plataforma.
Cuando ocurre un evento, Treble envía una solicitud HTTP **POST** a la URL que configures, incluyendo en el cuerpo un **JSON** con la información del evento. Tu servidor puede procesar esta información para ejecutar acciones específicas como actualizar registros, enviar alertas o iniciar procesos internos.
## Tipos de eventos disponibles
Actualmente puedes suscribirte a diferentes tipos de eventos globales:
* **Actualización del estado del HSM:** Notifica cuando un HSM cambia de estado.
* **Actualización de cierre de sesión:** Notifica cuando una sesión de conversación es cerrada.
* **Fallo de despliegue:** Notifica cuando ocurre un error durante un despliegue.
Cada uno de estos webhooks puede activarse o desactivarse según tus necesidades desde el panel de configuración.
## Requisitos
* Tu endpoint debe responder en menos de **5 segundos**.
* La respuesta debe ser un **cuerpo JSON válido**.
* Se recomienda usar **HTTPS** para mayor seguridad.
## Ejemplo básico
Aquí tienes un ejemplo en **Node.js** para manejar un webhook de Treble:
```javascript theme={null}
const express = require('express');
const app = express();
app.use(express.json());
app.post('/webhook', (req, res) => {
const { event_type } = req.body;
console.log('Evento recibido:', event_type);
// Procesa el evento según su tipo
switch (event_type) {
case 'hsm.status':
// Lógica para manejar cambios de estado HSM
break;
case 'session.close':
// Lógica para manejar cierre de sesión
break;
case 'deployment.failure':
// Lógica para manejar fallos de despliegue
break;
}
res.status(200).json({ success: true });
});
app.listen(3000, () => console.log('Webhook server escuchando en puerto 3000'));
```
# Dimensiones
Source: https://help.treble.ai/es/docs/data-warehouse-v2/dimensions
Tablas de catálogo para enriquecer tus consultas de hechos: agentes, equipos, plantillas, flujos, canales y nodos de flujo.
# Dimensiones
Las dimensiones son tablas de catálogo pequeñas que describen las entidades a las que hacen referencia tus hechos. Las tablas de hechos ya traen los nombres más comunes incluidos (`agent_name`, `poll_name`, `team_name`…), así que solo necesitas un join con una dimensión cuando quieres atributos más allá del nombre — el email de un agente, el estado de aprobación de un HSM, la configuración de IA de un nodo.
## dim\_agents
Una fila por cuenta de agente.
| Columna | Tipo | Descripción |
| ------------ | ------ | -------------------------------------------------------------- |
| `id` | Int32 | Identificador del agente (se une con `agent_id` en los hechos) |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `first_name` | String | Nombre |
| `last_name` | String | Apellido |
| `email` | String | Email del agente |
| `active` | Bool | Si el agente está disponible actualmente (en línea) |
| `agent_type` | String | Rol: `AGENT`, `ADMIN` o `SUPERVISOR` |
## dim\_teams
Una fila por equipo.
| Columna | Tipo | Descripción |
| ------------ | ------ | ------------------------ |
| `id` | Int32 | Identificador del equipo |
| `company_id` | Int32 | Tu empresa |
| `name` | String | Nombre del equipo |
## dim\_tags
Una fila por tag (cola/grupo dentro de un equipo).
| Columna | Tipo | Descripción |
| ------------ | ------ | ------------------------------ |
| `id` | Int32 | Identificador del tag |
| `company_id` | Int32 | Tu empresa |
| `name` | String | Nombre del tag |
| `team_id` | Int32 | Equipo al que pertenece el tag |
## dim\_agent\_tags
Una fila por asignación agente–tag — qué agentes atienden qué colas.
| Columna | Tipo | Descripción |
| ------------ | ------ | ----------------- |
| `agent_id` | Int32 | El agente |
| `company_id` | Int32 | Tu empresa |
| `tag_id` | Int32 | El tag asignado |
| `tag_name` | String | Nombre del tag |
| `team_id` | Int32 | Equipo del tag |
| `team_name` | String | Nombre del equipo |
## dim\_hsms
Una fila por HSM (plantilla de WhatsApp).
| Columna | Tipo | Descripción |
| --------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id` | Int32 | Identificador de la plantilla (se une con `hsm_id` en los hechos) |
| `company_id` | Int32 | Tu empresa |
| `name` | String | Nombre de la plantilla |
| `status` | String | Estado del ciclo de vida: `APPROVED`, `PROCESSING`, `REJECTED`, `PAUSED`, `DISABLED`, `ARCHIVED`, `PENDING_DELETION` |
| `category` | String | Categoría de Meta: `MARKETING`, `UTILITY`, `AUTHENTICATION`, más categorías legacy en plantillas antiguas (`ACCOUNT_UPDATE`, `ALERT_UPDATE`, `TRANSACTIONAL`, `OTP`, …) |
| `template_type` | String | `TEXT`, `RICH` o `MEDIA` |
| `content` | String | Contenido de texto de la plantilla |
| `provider_id` | String | ID de la plantilla en Meta |
## dim\_polls
Una fila por **versión** de flujo. Cuando editas un flujo en el editor, se crea una nueva versión (nuevo `poll_id`); `original_poll_id` agrupa todas las versiones del mismo flujo lógico.
| Columna | Tipo | Descripción |
| ------------------ | ------ | -------------------------------------------------------------------------- |
| `poll_id` | Int32 | Identificador de la versión del flujo (se une con `poll_id` en los hechos) |
| `poll_name` | String | Nombre del flujo |
| `original_poll_id` | Int32 | Identificador del flujo a través de sus versiones |
| `version` | UInt64 | Número de versión |
| `hidden` | Bool | Si esta versión está oculta en la plataforma |
| `company_id` | Int32 | Tu empresa |
Para analizar un flujo a través de sus ediciones, agrupa los hechos por `original_poll_id` vía esta dimensión en lugar de por el `poll_id` directo.
## dim\_channels
Una fila por línea de WhatsApp.
| Columna | Tipo | Descripción |
| --------------- | ---------- | --------------------------------------------------------------- |
| `company_id` | Int32 | Tu empresa |
| `channel_id` | Int32 | Identificador del canal (se une con `channel_id` en los hechos) |
| `whatsapp_line` | String | Número de teléfono de la línea |
| `display_name` | String | Nombre visible de la línea |
| `created_at` | DateTime64 | Cuándo se creó la línea |
## dim\_poll\_nodes
Una fila por nodo de cada versión de flujo — la estructura detrás de [`fact_treble_session_nodes`](/es/docs/data-warehouse-v2/fact-treble-session-nodes). Para los nodos de IA incluye la configuración completa del agente de IA.
| Columna | Tipo | Descripción |
| --------------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------- |
| `node_id` | Int32 | Identificador del nodo (se une con `node_id` / `last_node_id` en los hechos) |
| `company_id` | Int32 | Tu empresa |
| `poll_id` | Int32 | Versión del flujo a la que pertenece el nodo |
| `node_type` | String | Tipo de nodo: `QUESTION`, `AI_TASK_AUTOMATOR`, `AI_AGENT`, `WHATSAPP_FLOW`, `META_EVENTS`, `HELPDESK_INTEGRATION`, entre otros |
| `question_id` | Int32 | Identificador de la pregunta, cuando el nodo hace una; `0` en caso contrario |
| `question_text` | String | Texto de la pregunta |
| `question_type` | String | `OPEN` (texto libre), `CLOSED` (opciones predefinidas) o `AGENT` (transfiere a un agente); vacío para nodos que no son pregunta |
| `hsm_id` | Int32 | Plantilla HSM que envía el nodo, si aplica; `0` en caso contrario |
| `ai_automator_id` | Int64 | Agente de IA configurado en el nodo, si aplica; `0` en caso contrario |
| `ai_automator_name` | String | Nombre del agente de IA |
| `ai_automator_description` | String | Descripción del agente de IA |
| `ai_automator_version` | Int32 | Última versión del agente de IA vinculada a este nodo |
| `ai_automator_active` | Bool | Si esa última versión está activa |
| `ai_automator_tools` | String | Herramientas habilitadas para el agente de IA (JSON) |
| `ai_automator_instructions` | String | Instrucciones del agente de IA |
## Ejemplo: enriquecer un funnel con el texto del nodo
```sql theme={null}
SELECT
f.node_id,
n.node_type,
n.question_text,
uniqExact(f.session_id) AS conversations_reached
FROM fact_treble_session_nodes AS f
LEFT JOIN dim_poll_nodes AS n
ON n.company_id = f.company_id AND n.poll_id = f.poll_id AND n.node_id = f.node_id
WHERE f.poll_id = {your_poll_id}
AND f.entered_at >= today() - 30
GROUP BY f.node_id, n.node_type, n.question_text
ORDER BY conversations_reached DESC
```
# fact_ad_sessions
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-ad-sessions
Conversaciones que comenzaron desde un anuncio Click-to-WhatsApp, con los detalles del creativo del anuncio.
# fact\_ad\_sessions
Cada fila es una conversación que comenzó cuando un usuario hizo clic en un anuncio **Click-to-WhatsApp** (Facebook/Instagram), junto con el creativo que lo trajo: título, cuerpo, medio y el id de origen del anuncio. Únela con `fact_treble_sessions` a través de `session_id` para analizar resultados. Este dataset no estaba disponible en el warehouse anterior.
## ¿Qué preguntas responde?
* ¿Qué anuncios generan más conversaciones de WhatsApp?
* ¿Qué creativos (título/cuerpo/medio) convierten mejor una vez que comienza la conversación?
* ¿Cuál es el funnel desde el clic en el anuncio hasta el objetivo (join con `fact_target_events`)?
## Columnas
| Columna | Tipo | Descripción |
| --------------- | ---------- | ---------------------------------------------------------------------------- |
| `session_id` | Int64 | La conversación que inició el anuncio (join con `fact_treble_sessions`) |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `created_at` | DateTime64 | Cuándo comenzó la conversación |
| `headline` | String | Título del anuncio |
| `body` | String | Texto del cuerpo del anuncio |
| `source_type` | String | `ad` o `post`; ocasionalmente vacío cuando Meta no envía el campo |
| `source_id` | String | ID del anuncio/post en Meta — clave para cruzar con tu reporting de Meta Ads |
| `source_url` | String | URL del anuncio/post |
| `media_type` | String | `image` o `video`; ocasionalmente vacío |
| `image_url` | String | URL de la imagen del creativo, cuando el medio es una imagen |
| `video_url` | String | URL del video del creativo, cuando el medio es un video |
| `thumbnail_url` | String | URL de la miniatura del video |
| `treble_image` | String | Copia del creativo almacenada por Treble |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Conversaciones por anuncio, últimos 30 días
```sql theme={null}
SELECT source_id, any(headline) AS headline, count() AS conversations
FROM fact_ad_sessions
WHERE created_at >= today() - 30
GROUP BY source_id
ORDER BY conversations DESC
```
### Del anuncio a la conversión
```sql theme={null}
SELECT
a.source_id,
any(a.headline) AS headline,
uniqExact(a.session_id) AS conversations,
uniqExact(t.session_id) AS converted
FROM fact_ad_sessions AS a
LEFT JOIN fact_target_events AS t
ON t.company_id = a.company_id AND t.session_id = a.session_id
WHERE a.created_at >= today() - 30
GROUP BY a.source_id
ORDER BY conversations DESC
```
# fact_agent_conversation_messages
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-agent-conversation-messages
Cada mensaje intercambiado dentro de las conversaciones de agente.
# fact\_agent\_conversation\_messages
Cada fila es un mensaje dentro de una conversación de agente: qué escribió el cliente, qué respondió el agente, y cuándo fue entregado y leído. Reemplaza a la tabla legacy `fact_agent_messages`.
## ¿Qué preguntas responde?
* ¿Qué se dijo en una conversación de agente, en orden?
* ¿Cuántos mensajes envía cada agente por día?
* ¿Qué tan rápido leen los clientes los mensajes de los agentes?
* ¿Qué proporción del tráfico de agentes es multimedia vs texto?
## Columnas
| Columna | Tipo | Descripción |
| ----------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `message_id` | Int32 | Identificador único del mensaje |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `agent_conversation_id` | Int32 | La conversación de agente a la que pertenece |
| `session_id` | Int64 | El flujo conversacional de origen; `0` si no hay |
| `created_at` | DateTime64 | Cuándo se envió el mensaje |
| `sender` | String | `USER` (cliente), `AGENT` (agente humano) o `AI` (asistente de IA respondiendo en la conversación) |
| `category` | String | `text`, `image`, `audio`, `video`, `document`, `hsm`, `sticker`, `location`, `contacts`, `whatsapp_flow`, `whatsapp_flow_response`, `call_request_permission` |
| `content` | String | Contenido del mensaje (texto, o URL del medio para archivos) |
| `agent_id` | Int32 | Agente que lo envió; `0` para mensajes de `USER` y `AI` |
| `agent_name` | String | Nombre de ese agente |
| `tag_id` | Int32 | Tag de la conversación al momento del envío |
| `team_name` | String | Nombre del equipo |
| `read_at` | DateTime64 | Cuándo lo leyó el destinatario; `NULL` si no fue leído |
| `delivered_at` | DateTime64 | Cuándo WhatsApp confirmó la entrega |
| `wa_id` | String | ID del mensaje en WhatsApp (`wamid`) |
| `reply_provider_msg_id` | String | Si cita/responde a otro mensaje, el `wamid` de ese mensaje |
| `reaction` | String | Reacción con emoji, si la hay |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
Los mensajes de conversaciones que fueron eliminadas en la plataforma se excluyen — cada fila aquí tiene un padre vigente en [`fact_agent_conversations`](/es/docs/data-warehouse-v2/fact-agent-conversations).
## Consultas de ejemplo
### Reconstruir una conversación de agente
```sql theme={null}
SELECT created_at, sender, agent_name, category, content
FROM fact_agent_conversation_messages
WHERE agent_conversation_id = {your_conversation_id}
ORDER BY created_at
```
### Mensajes enviados por agente por día
```sql theme={null}
SELECT
agent_name,
toDate(created_at) AS day,
count() AS messages_sent
FROM fact_agent_conversation_messages
WHERE sender = 'AGENT'
AND created_at >= today() - 7
GROUP BY agent_name, day
ORDER BY day, messages_sent DESC
```
# fact_agent_conversation_transfers
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-agent-conversation-transfers
Cada transferencia de una conversación entre agentes o equipos.
# fact\_agent\_conversation\_transfers
Cada fila es un evento de transferencia: una conversación moviéndose de un agente a otro (o a la cola de otro equipo). Reemplaza a la tabla legacy `fact_redirections`.
## ¿Qué preguntas responde?
* ¿Quién transfiere más, y a quién?
* ¿Qué equipos reciben más trabajo transferido?
* ¿Cómo se ve la cadena completa de custodia de una conversación?
## Columnas
| Columna | Tipo | Descripción |
| ----------------------- | ---------- | -------------------------------------------------------------------------------------------------------------- |
| `transfer_id` | Int32 | Identificador único de la transferencia |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `agent_conversation_id` | Int32 | La conversación que se transfiere |
| `session_id` | Int64 | El flujo conversacional de origen; `0` si no hay |
| `created_at` | DateTime64 | Cuándo ocurrió la transferencia |
| `from_agent_id` | Int32 | Agente que entrega la conversación |
| `from_agent_name` | String | Nombre de ese agente |
| `to_agent_id` | Int32 | Agente que recibe la conversación |
| `to_agent_name` | String | Nombre de ese agente |
| `owner_agent_id` | Int32 | El agente que ejecutó la transferencia — difiere de `from_agent_id` cuando un supervisor mueve la conversación |
| `tag_id` | Int32 | Tag (cola) al que pertenece la conversación |
| `team_name` | String | Equipo de ese tag |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Flujos de transferencia entre agentes, últimos 30 días
```sql theme={null}
SELECT from_agent_name, to_agent_name, count() AS transfers
FROM fact_agent_conversation_transfers
WHERE created_at >= today() - 30
GROUP BY from_agent_name, to_agent_name
ORDER BY transfers DESC
LIMIT 20
```
### Cadena de custodia de una conversación
```sql theme={null}
SELECT created_at, from_agent_name, to_agent_name, team_name
FROM fact_agent_conversation_transfers
WHERE agent_conversation_id = {your_conversation_id}
ORDER BY created_at
```
# fact_agent_conversations
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-agent-conversations
Conversaciones atendidas por agentes humanos en el espacio de trabajo de agentes.
# fact\_agent\_conversations
Cada fila es una conversación atendida en el espacio de trabajo de agentes (Sales): quién la tomó, cómo se asignó, cuánto esperó el cliente, cómo terminó y cómo la calificó el cliente. Reemplaza a la tabla legacy `fact_conversations` — ahora con **historia completa** (la tabla legacy mantenía una ventana móvil de 3 meses) y mayor detalle de asignación/transferencias.
## ¿Qué preguntas responde?
* ¿Cuántas conversaciones atiende cada agente/equipo, y cómo se resuelven?
* ¿Cuál es el tiempo de primera respuesta y cómo varía por equipo u hora?
* ¿Qué conversaciones fueron transferidas, y cuántas veces?
* ¿Qué CSAT obtienen los agentes?
* ¿Cómo llegó la conversación — desde qué flujo, inbound u outbound?
## Columnas
| Columna | Tipo | Descripción |
| --------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `agent_conversation_id` | Int32 | Identificador único de la conversación |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `session_id` | Int64 | El flujo conversacional que transfirió a un agente (se une con `fact_treble_sessions`); `0` si no hay |
| `contact_id` | Int32 | Contacto de Treble; `0` si no hay |
| `created_at` | DateTime64 | Cuándo entró la conversación al espacio de trabajo |
| `finished_at` | DateTime64 | Cuándo se resolvió; `NULL` si sigue abierta |
| `assigned_at` | DateTime64 | Cuándo se asignó un agente; `NULL` si nunca se asignó |
| `status` | String | Estado actual: `unassigned` (esperando en cola), `assigned` (con un agente), `finished` |
| `finish_type` | String | Cómo terminó: `MANUAL` (cerrada por el agente) o `AUTO` (cerrada automáticamente); vacío mientras está abierta |
| `rating` | Int32 | Calificación de satisfacción del cliente 1–5; `0` si no fue calificada |
| `is_redirected` | Bool | `true` si la conversación fue transferida al menos una vez |
| `agent_id` | Int32 | Agente responsable actual/último; `0` si no está asignada |
| `agent_name` | String | Nombre de ese agente |
| `tag_id` | Int32 | Tag (cola/grupo) al que pertenece la conversación |
| `tag_name` | String | Nombre del tag |
| `team_id` | Int32 | Equipo dueño del tag |
| `team_name` | String | Nombre del equipo |
| `channel_id` | Int32 | Línea de WhatsApp |
| `direction` | String | Origen `INBOUND` u `OUTBOUND` del flujo subyacente; vacío si no hay flujo vinculado |
| `poll_id` | Int32 | Flujo que originó la conversación; `0` si no hay |
| `poll_name` | String | Nombre del flujo |
| `transfer_count` | UInt32 | Número de transferencias |
| `first_agent_message_at` | DateTime64 | Primer mensaje enviado por un agente; `NULL` si aún no hay |
| `first_response_sec` | Int64 | Segundos desde la creación de la conversación hasta el primer mensaje de agente; `NULL` si aún no hay mensaje de agente |
| `helpdesk_contact_id` | String | ID del contacto en tu CRM, cuando está integrado |
| `contact_wa_id` | String | ID de WhatsApp del contacto |
| `transfer_waiting_time` | Int32 | Límite configurado (minutos) para esperar al agente dueño del contacto en el CRM antes de asignar al pool. Valores especiales: `-1` = asignar al dueño de inmediato, `-2` = esperar hasta que el dueño esté en línea. `NULL` cuando no está configurado |
| `last_customer_interaction` | DateTime64 | Último mensaje del cliente |
| `assign_type` | String | Cómo la recibió el agente: `AUTO` (asignada por la plataforma) o `MANUAL` |
| `assignment_strategy` | String | Estrategia de asignación por flujo: `lowest_first`, `specific`, `owner` o `random`; vacío cuando aplica el default a nivel de empresa |
| `language` | String | Idioma de la conversación: `ES`, `PT`, `EN`, `FR`, `DE`, `IT` |
| `channel` | String | Tipo de canal (actualmente `WHATSAPP`) |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Volumen y resolución por equipo, últimos 30 días
```sql theme={null}
SELECT
team_name,
count() AS conversations,
countIf(status = 'finished') AS finished,
round(avg(first_response_sec) / 60, 1) AS avg_first_response_min,
round(avgIf(rating, rating != 0), 2) AS csat
FROM fact_agent_conversations
WHERE created_at >= today() - 30
GROUP BY team_name
ORDER BY conversations DESC
```
### Conversaciones transferidas más de una vez
```sql theme={null}
SELECT agent_conversation_id, agent_name, transfer_count, created_at
FROM fact_agent_conversations
WHERE created_at >= today() - 7
AND transfer_count > 1
ORDER BY transfer_count DESC
```
Para ver la conversación completa con el bot que precedió a la transferencia, une `session_id` contra [`fact_treble_sessions`](/es/docs/data-warehouse-v2/fact-treble-sessions) y [`fact_treble_session_messages`](/es/docs/data-warehouse-v2/fact-treble-session-messages).
# fact_agent_daily
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-agent-daily
Métricas diarias de productividad por agente, preagregadas.
# fact\_agent\_daily
Cada fila es un agente en un día, con sus métricas de carga de trabajo, velocidad, resolución y satisfacción ya calculadas. Es el camino rápido para dashboards de desempeño de agentes; para cortes personalizados, deriva desde [`fact_agent_conversations`](/es/docs/data-warehouse-v2/fact-agent-conversations) y [`fact_agent_conversation_messages`](/es/docs/data-warehouse-v2/fact-agent-conversation-messages).
## ¿Qué preguntas responde?
* ¿Cuántos chats atendió, resolvió y transfirió cada agente por día?
* ¿Cuáles son los tiempos de respuesta y el CSAT de cada agente?
* ¿Cuántos minutos estuvo disponible cada agente?
* ¿Qué proporción de conversaciones recibió una primera respuesta dentro del objetivo de nivel de servicio de 2 minutos?
Solo existe una fila para los días en que el agente **envió al menos un mensaje**. Las métricas de conversación atribuyen cada conversación al día en que fue creada y al agente responsable de ella.
## Columnas
| Columna | Tipo | Descripción |
| ---------------------------- | ---------- | --------------------------------------------------------------------------------------------------------- |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `agent_id` | Int32 | El agente |
| `agent_name` | String | Nombre del agente |
| `day` | Date | El día |
| `chats_handled` | UInt64 | Conversaciones creadas ese día de las que el agente es/fue responsable |
| `chats_resolved` | UInt64 | De esas, cuántas están finalizadas |
| `chats_transferred_sent` | UInt64 | Transferencias que el agente envió ese día |
| `chats_transferred_received` | UInt64 | Transferencias que el agente recibió ese día |
| `messages_sent` | UInt64 | Mensajes que el agente envió ese día |
| `hsm_messages_sent` | UInt64 | De esos, mensajes de plantilla HSM |
| `first_message_at` | DateTime64 | Primer mensaje del agente en el día |
| `last_message_at` | DateTime64 | Último mensaje del agente en el día |
| `avg_first_response_sec` | Float64 | Segundos promedio desde la creación de una conversación hasta el primer mensaje del agente |
| `avg_response_time_sec` | Float64 | Segundos promedio que tarda el agente en responder después de un mensaje del cliente |
| `avg_resolution_min` | Float64 | Minutos promedio desde la creación de una conversación hasta su resolución |
| `csat_avg` | Float64 | Calificación promedio, considerando solo las conversaciones calificadas |
| `service_level_pct` | Float64 | Fracción (0–1) de las conversaciones respondidas ese día cuya primera respuesta llegó dentro de 2 minutos |
| `available_minutes` | Int64 | Minutos que el agente estuvo en estado disponible, derivado de sus cambios de estado |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Scorecard del equipo para la última semana
```sql theme={null}
SELECT
agent_name,
sum(chats_handled) AS chats,
sum(chats_resolved) AS resolved,
round(avg(avg_first_response_sec), 0) AS avg_first_response_sec,
round(avg(csat_avg), 2) AS csat,
round(sum(available_minutes) / 60, 1) AS available_hours
FROM fact_agent_daily
WHERE day >= today() - 7
GROUP BY agent_name
ORDER BY chats DESC
```
### Tendencia de un agente durante un mes
```sql theme={null}
SELECT day, chats_handled, avg_first_response_sec, csat_avg
FROM fact_agent_daily
WHERE agent_id = {your_agent_id}
AND day >= today() - 30
ORDER BY day
```
# fact_agent_status_changes
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-agent-status-changes
El historial de disponibilidad de cada agente.
# fact\_agent\_status\_changes
Cada fila es un cambio en la disponibilidad de un agente: conectarse (disponible para recibir conversaciones) o desconectarse. Reconstruir la secuencia te da el tiempo conectado y los patrones de disponibilidad de cada agente.
## ¿Qué preguntas responde?
* ¿Cuántas horas estuvo disponible cada agente por día?
* ¿Cuándo se conectan y desconectan los agentes?
* ¿Cómo se alinea la disponibilidad del equipo con la demanda de conversaciones?
## Columnas
| Columna | Tipo | Descripción |
| ------------------ | ---------- | ------------------------------------------------------------------------------- |
| `status_change_id` | Int32 | Identificador único del cambio |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `agent_id` | Int32 | El agente |
| `agent_name` | String | Nombre del agente |
| `created_at` | DateTime64 | Cuándo cambió el estado |
| `old_status` | Bool | Disponibilidad antes del cambio: `true` = disponible, `false` = no disponible |
| `new_status` | Bool | Disponibilidad después del cambio: `true` = disponible, `false` = no disponible |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Minutos disponibles diarios por agente (reconstrucción de intervalos)
```sql theme={null}
SELECT
agent_name,
toDate(created_at) AS day,
round(sum(
dateDiff('second', created_at,
leadInFrame(created_at) OVER (
PARTITION BY agent_id, toDate(created_at)
ORDER BY created_at
ROWS BETWEEN CURRENT ROW AND 1 FOLLOWING))
* if(new_status = true, 1, 0)
) / 60, 1) AS available_minutes
FROM fact_agent_status_changes
WHERE created_at >= today() - 7
GROUP BY agent_name, day
ORDER BY day, agent_name
```
Para la mayoría de los reportes no necesitas reconstruir los intervalos tú mismo — [`fact_agent_daily`](/es/docs/data-warehouse-v2/fact-agent-daily) ya expone `available_minutes` por agente por día.
# fact_campaign_daily
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-campaign-daily
Métricas diarias de entrega por campaña, preagregadas.
# fact\_campaign\_daily
Cada fila es una campaña (`poll_id`) en un día, con los envíos desglosados por resultado y las tasas de entrega/respuesta ya calculadas. Es el camino rápido para dashboards: los mismos números que podrías derivar de [`fact_campaign_sends`](/es/docs/data-warehouse-v2/fact-campaign-sends), preagregados. Reemplaza a la tabla legacy `fact_deployment_daily` con fórmulas idénticas.
## ¿Qué preguntas responde?
* ¿Cómo le fue a cada campaña por día?
* ¿Cuál es la tendencia de las tasas de entrega y respuesta en el tiempo?
* ¿Cuántos envíos fallaron, y en qué categoría de falla?
## Columnas
| Columna | Tipo | Descripción |
| --------------------------- | ---------- | ----------------------------------------------------------------------------- |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `day` | Date | El día (por hora programada) |
| `poll_id` | Int32 | Identificador del flujo de la campaña |
| `poll_name` | String | Nombre del flujo de la campaña |
| `sent` | UInt64 | Total de envíos programados ese día, considerando todos los resultados |
| `delivered` | UInt64 | Envíos que llegaron al teléfono (`delivered_at` definido) |
| `responded` | UInt64 | Envíos que el usuario respondió (`responded_at` definido) |
| `failure` | UInt64 | Envíos fallidos (`failed_at` definido — todas las causas de falla combinadas) |
| `in_process` | UInt64 | Envíos aceptados o en curso, aún sin resultado final de entrega |
| `failure_rate_limit` | UInt64 | Fallas: se alcanzó el límite de velocidad de mensajería |
| `revoked` | UInt64 | Envíos revocados antes de enviarse |
| `invalid_phone` | UInt64 | Fallas: número de teléfono inválido |
| `missing_parameter` | UInt64 | Fallas: parámetro de plantilla faltante o inconsistente |
| `failure_human_handover` | UInt64 | Fallas: el contacto estaba en una conversación con un agente |
| `deactivated_poll_or_hsm` | UInt64 | Fallas: flujo o plantilla desactivados |
| `failure_general` | UInt64 | Fallas: generales/otras |
| `failure_unable_to_contact` | UInt64 | Fallas: WhatsApp no pudo entregar a ese número |
| `optout` | UInt64 | Fallas: el destinatario se dio de baja o bloqueó la línea |
| `meta_chose_not_deliver` | UInt64 | Meta decidió no entregar (frequency capping) |
| `to_agents` | UInt64 | Conversaciones de este flujo transferidas a agentes ese día |
| `delivered_rate_pct` | Float64 | `delivered / sent` × 100; `NULL` cuando `sent` es 0 |
| `response_rate_pct` | Float64 | `responded / delivered` × 100; `NULL` cuando `delivered` es 0 |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
Las filas de días recientes se recalculan continuamente a medida que los envíos avanzan — la fila de hoy seguirá cambiando hasta que los envíos subyacentes se consoliden (dentro de 48 horas). Para desgloses personalizados no cubiertos aquí, consulta `fact_campaign_sends` directamente.
Las columnas de desglose de fallas cubren las causas de falla más comunes; `failure` es el total autoritativo y puede ser ligeramente mayor que la suma de las columnas de desglose cuando un envío falló por una razón menos común. El detalle completo siempre está disponible por envío en `fact_campaign_sends.status`.
## Consultas de ejemplo
### Últimos 30 días de una campaña
```sql theme={null}
SELECT day, sent, delivered, responded, delivered_rate_pct, response_rate_pct
FROM fact_campaign_daily
WHERE poll_id = {your_poll_id}
AND day >= today() - 30
ORDER BY day
```
### Desglose de fallas de todas las campañas este mes
```sql theme={null}
SELECT
sum(invalid_phone) AS invalid_phone,
sum(failure_rate_limit) AS rate_limit,
sum(missing_parameter) AS missing_parameter,
sum(failure_unable_to_contact) AS unable_to_contact,
sum(meta_chose_not_deliver) AS meta_frequency_capping,
sum(failure_general) AS general
FROM fact_campaign_daily
WHERE day >= toStartOfMonth(today())
```
# fact_campaign_sends
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-campaign-sends
Cada mensaje outbound de campaña con su ciclo de vida de entrega completo.
# fact\_campaign\_sends
Cada fila es un mensaje outbound de una campaña a un destinatario, con su ciclo de vida de entrega completo: programado → enviado → entregado → respondido, o la razón exacta de la falla. Reemplaza a la tabla legacy `fact_deployment_status`.
## ¿Qué preguntas responde?
* ¿Cuál es la tasa de entrega y de respuesta de cada campaña?
* ¿Qué destinatarios específicos fallaron, y por qué?
* ¿Cuánto tarda el recorrido programado → entregado → respondido?
* ¿Qué envíos fueron reintentados?
* ¿Cuánto tráfico viene de cada canal — API, carga de archivos, integraciones de CRM (`origin`)?
## Columnas
| Columna | Tipo | Descripción |
| ------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `deployment_id` | String | Identificador único del envío (hex de 56 caracteres) |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `batch_id` | String | El lote al que pertenece este envío (una ejecución de campaña) |
| `status` | String | Estado actual del ciclo de vida. Camino exitoso: `DELIVERED`, `SUCCESS` (enviado, entrega aún no confirmada). En curso: `RECEIVED`, `RECEIVED_BY_WORKER`, `RETRY`. Cancelado: `REVOKED`. Rechazado antes de enviar: `INVALID_PHONE`, `INVALID_POLL`, `MISSING_PARAMETER`, `PARAMETER_MISMATCH`, `VALIDATION_ERROR`. Fallido: `FAILURE` y la familia `FAILURE_BY_*` (`_UNABLE_TO_CONTACT`, `_DISABLED_HSM`, `_META_CHOSE_NOT_DELIVER`, `_HUMAN_HANDOVER`, `_OPTOUT_CONTACT`, `_RATE_LIMIT`, entre otros) |
| `retries` | Int32 | Número de reintentos |
| `poll_id` | Int32 | Flujo que dispara la campaña |
| `poll_name` | String | Nombre del flujo |
| `origin` | String | De dónde vino el envío: `API`, `CSV` (carga de archivo en la plataforma), `SIMPLE` (envío directo desde la plataforma), `APP_INTEGRATION`, `HELPDESK_INTEGRATION` |
| `origin_id` | Int32 | Identificador del origen: el usuario de la plataforma que lo lanzó (`CSV`/`SIMPLE`), la integración que lo disparó (`APP_INTEGRATION`/`HELPDESK_INTEGRATION`), o el id provisto por quien llamó la API; `0` cuando no está definido |
| `scheduled_at` | DateTime64 | Cuándo se programó el envío |
| `received_at` | DateTime64 | Cuándo WhatsApp aceptó el mensaje; `NULL` si no ocurrió |
| `delivered_at` | DateTime64 | Cuándo llegó al teléfono del usuario; `NULL` si no ocurrió |
| `responded_at` | DateTime64 | Cuándo respondió el usuario; `NULL` si no respondió |
| `failed_at` | DateTime64 | Cuándo falló; `NULL` si fue exitoso |
| `succeeded_at` | DateTime64 | Cuándo se confirmó como exitoso; `NULL` en caso contrario |
| `cellphone` | String | Número de teléfono del destinatario |
| `country_code` | String | Código de país del destinatario |
| `treble_id` | String | Identidad del contacto (código de país + celular) |
| `business_scope_id` | String | ID de usuario business-scoped de WhatsApp, cuando está disponible |
| `username` | String | Nombre de usuario de WhatsApp, para contactos sin número de teléfono |
| `scheduled` | Bool | `true` si el envío se programó para un momento futuro en lugar de enviarse de inmediato |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
Los estados siguen cambiando mientras una campaña está en curso. Según [el contrato de datos](/es/docs/data-warehouse-v2/welcome#el-contrato-de-datos), las cifras de un día se consolidan por completo dentro de 48 horas — el warehouse actualiza cada fila en su lugar a medida que su estado avanza.
## Consultas de ejemplo
### Scorecard de campañas
```sql theme={null}
SELECT
poll_name,
count() AS sends,
countIf(delivered_at IS NOT NULL) AS delivered,
countIf(responded_at IS NOT NULL) AS responded,
round(100.0 * delivered / sends, 1) AS delivery_pct,
round(100.0 * responded / delivered, 1) AS response_of_delivered_pct
FROM fact_campaign_sends
WHERE scheduled_at >= today() - 30
GROUP BY poll_name
ORDER BY sends DESC
```
### Destinatarios fallidos de un lote
```sql theme={null}
SELECT cellphone, status, retries, failed_at
FROM fact_campaign_sends
WHERE batch_id = '{your_batch_id}'
AND failed_at IS NOT NULL
ORDER BY failed_at
```
### Tiempo hasta la respuesta
```sql theme={null}
SELECT
poll_name,
round(avg(dateDiff('minute', delivered_at, responded_at)), 1) AS avg_minutes_to_reply
FROM fact_campaign_sends
WHERE scheduled_at >= today() - 30
AND delivered_at IS NOT NULL
AND responded_at IS NOT NULL
GROUP BY poll_name
```
# fact_hsm_responses
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-hsm-responses
Respuestas que los usuarios dieron a las preguntas de plantillas HSM.
# fact\_hsm\_responses
Cada fila es una respuesta que un usuario dio a un paso del flujo que envió un HSM (plantilla de WhatsApp) — típicamente los botones o respuestas rápidas del mensaje inicial de una campaña. Es un subconjunto enfocado de [`fact_treble_session_nodes`](/es/docs/data-warehouse-v2/fact-treble-session-nodes): solo los pasos con una plantilla que recibió una respuesta.
## ¿Qué preguntas responde?
* ¿Qué botón/opción eligen los usuarios cuando responden a una plantilla?
* ¿Qué plantillas generan más interacción?
* ¿Qué respondieron exactamente los usuarios a cada plantilla?
## Columnas
| Columna | Tipo | Descripción |
| ----------------------- | ---------- | ----------------------------------------------------------------------------------------------------------- |
| `interaction_answer_id` | Int64 | Identificador único de la respuesta — igual a `fact_treble_session_nodes.node_record_id` para el mismo paso |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `session_id` | Int64 | El flujo conversacional al que pertenece |
| `hsm_id` | Int32 | Plantilla HSM (se une con `dim_hsms`) |
| `hsm_name` | String | Nombre de la plantilla |
| `answer_text` | String | El texto de la respuesta del usuario |
| `responded_at` | DateTime64 | Cuándo respondió el usuario (siempre definido — las plantillas sin respuesta no están en esta tabla) |
| `poll_id` | Int32 | Identificador del flujo |
| `poll_name` | String | Nombre del flujo |
| `cellphone` | String | Número de teléfono del usuario |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Distribución de respuestas por plantilla, últimos 30 días
```sql theme={null}
SELECT hsm_name, answer_text, count() AS answers
FROM fact_hsm_responses
WHERE responded_at >= today() - 30
GROUP BY hsm_name, answer_text
ORDER BY hsm_name, answers DESC
```
# fact_target_events
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-target-events
Eventos de conversión y objetivo disparados dentro de los flujos conversacionales.
# fact\_target\_events
Cada fila es un evento objetivo (meta/conversión) disparado por un flujo conversacional — el momento en que un usuario llegó a un nodo que marcaste como objetivo: completó una intención de compra, confirmó una cita, calificó como lead.
## ¿Qué preguntas responde?
* ¿Cuántas conversiones generó cada flujo?
* ¿Qué usuarios específicos convirtieron, y cuándo?
* ¿Cuál es la tasa de conversión de una campaña (join con envíos o sesiones)?
## Columnas
| Columna | Tipo | Descripción |
| ----------------- | ---------- | ------------------------------------------------------------------------------------- |
| `event_id` | Int64 | Identificador único del evento |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `session_id` | Int64 | El flujo conversacional donde se disparó |
| `target_event_id` | Int32 | Identificador de la definición del evento objetivo — la clave para distinguir eventos |
| `node_id` | Int32 | El nodo del flujo al que está asociado el evento objetivo |
| `question_text` | String | Texto de la pregunta en ese nodo — la etiqueta más descriptiva del evento |
| `poll_id` | Int32 | Identificador del flujo; `0` si no se resolvió |
| `poll_name` | String | Nombre del flujo |
| `cellphone` | String | Número de teléfono del usuario |
| `created_at` | DateTime64 | Cuándo se disparó el evento |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Conversiones por flujo, últimos 30 días
```sql theme={null}
SELECT poll_name, target_event_id, any(question_text) AS step, count() AS conversions
FROM fact_target_events
WHERE created_at >= today() - 30
GROUP BY poll_name, target_event_id
ORDER BY conversions DESC
```
### Tasa de conversión de un flujo
```sql theme={null}
SELECT
uniqExact(t.session_id) AS converted_sessions,
(SELECT count() FROM fact_treble_sessions
WHERE poll_id = {your_poll_id}
AND created_at >= today() - 30) AS total_sessions,
round(100.0 * converted_sessions / total_sessions, 1) AS conversion_pct
FROM fact_target_events AS t
WHERE t.poll_id = {your_poll_id}
AND t.created_at >= today() - 30
```
# fact_treble_session_messages
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-treble-session-messages
Cada mensaje intercambiado dentro de los flujos conversacionales — la traza completa.
# fact\_treble\_session\_messages
Cada fila es un mensaje dentro de un flujo conversacional: qué envió el bot (o un agente de IA), qué respondió el usuario, cuándo fue entregado y leído. Esta tabla no existía en el warehouse anterior — te da la transcripción completa de cada conversación de flujo.
## ¿Qué preguntas responde?
* ¿Qué se dijo exactamente en una conversación, en orden?
* ¿Qué mensajes fallan en la entrega y con qué error?
* ¿Cuánto tardan los usuarios en leer nuestros mensajes?
* ¿Qué plantillas HSM se están enviando realmente dentro de los flujos?
* ¿Qué respondió la IA en las conversaciones con IA?
## Columnas
| Columna | Tipo | Descripción |
| ----------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `message_id` | Int64 | Identificador único del mensaje |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `session_id` | Int64 | El flujo conversacional al que pertenece este mensaje |
| `created_at` | DateTime64 | Cuándo se creó el mensaje |
| `sender` | String | Quién lo envió: `AI` (el flujo automatizado), `USER` (el usuario final) o `HELPDESK_INTEGRATION` (enviado a través de una integración de CRM/helpdesk conectada) |
| `type` | String | Tipo de mensaje: `TEXT`, `HSM`, `IMAGE`, `AUDIO`, `VIDEO`, `DOCUMENT`, `STICKER`, `LOCATION`, `CONTACTS`, `WHATSAPP_FLOW`, `WHATSAPP_FLOW_RESPONSE`, `CALL_REQUEST_PERMISSION` |
| `text` | String | Contenido de texto del mensaje |
| `file_url` | String | URL del medio cuando el mensaje incluye un archivo |
| `filename` | String | Nombre original del archivo para documentos |
| `hsm_id` | Int32 | Plantilla HSM usada, si aplica; `0` en caso contrario |
| `hsm_name` | String | Nombre de la plantilla HSM |
| `delivered_at` | DateTime64 | Cuándo WhatsApp confirmó la entrega; `NULL` si no fue (aún) entregado |
| `read_at` | DateTime64 | Cuándo lo leyó el usuario; `NULL` si no fue leído |
| `error` | String | Descripción del error de entrega; vacío si fue exitoso |
| `provider_msg_id` | String | ID del mensaje en WhatsApp (`wamid`) |
| `reply_provider_msg_id` | String | Si el mensaje cita/responde a otro, el `wamid` de ese mensaje |
| `interaction_answer_id` | Int64 | El paso del flujo al que pertenece este mensaje — se une con `fact_treble_session_nodes.node_record_id`; `0` cuando el mensaje no está ligado a un paso |
| `contact_id` | Int32 | Contacto de Treble; `0` si no hay |
| `reaction` | String | Reacción con emoji, si el usuario reaccionó al mensaje |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Reconstruir una conversación
```sql theme={null}
SELECT created_at, sender, type, text, delivered_at, read_at
FROM fact_treble_session_messages
WHERE session_id = {your_session_id}
ORDER BY created_at
```
### Errores de entrega en las últimas 24 horas
```sql theme={null}
SELECT error, count() AS messages
FROM fact_treble_session_messages
WHERE created_at >= now() - INTERVAL 24 HOUR
AND error != ''
GROUP BY error
ORDER BY messages DESC
```
Casi todos los mensajes traen `interaction_answer_id` — tanto la pregunta que envió el flujo como la respuesta del usuario apuntan al mismo paso. Para emparejar respuestas con preguntas, únelo contra `fact_treble_session_nodes.node_record_id`.
# fact_treble_session_nodes
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-treble-session-nodes
El recorrido nodo a nodo de cada conversación a través de su flujo.
# fact\_treble\_session\_nodes
Cada fila es un **paso interactivo** de una conversación a través de su flujo: una pregunta realizada, un paso de IA, un WhatsApp Flow, una llamada a una integración — con la opción que el usuario eligió o el texto libre que escribió, y si en lugar de responder se agotó el tiempo de espera. Esta es la tabla para **funnels** — no existía en el warehouse anterior.
Los pasos que solo envían un mensaje y continúan (sin interacción) no generan una fila aquí — el flujo completo de mensajes, incluidos esos, está en [`fact_treble_session_messages`](/es/docs/data-warehouse-v2/fact-treble-session-messages). La estructura completa de cada flujo, con todos sus nodos, está en [`dim_poll_nodes`](/es/docs/data-warehouse-v2/dimensions#dim_poll_nodes).
## ¿Qué preguntas responde?
* ¿Cuál es el funnel paso a paso de un flujo — cuántos usuarios llegan a cada nodo y dónde abandonan?
* ¿Qué opciones de respuesta eligen los usuarios en cada pregunta?
* ¿Qué preguntas agotan el tiempo de espera con más frecuencia?
* ¿Qué conversaciones pasaron por nodos de IA (join con `dim_poll_nodes.node_type`)?
* ¿Cuánto tardan los usuarios en responder cada pregunta?
## Columnas
| Columna | Tipo | Descripción |
| -------------------- | ---------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `node_record_id` | Int64 | Identificador único de esta visita al nodo |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `session_id` | Int64 | El flujo conversacional al que pertenece esta visita |
| `poll_id` | Int32 | Identificador del flujo |
| `poll_name` | String | Nombre del flujo |
| `cellphone` | String | Número de teléfono del usuario |
| `treble_id` | String | Identidad del contacto (código de país + celular) |
| `node_id` | Int32 | El nodo del flujo visitado (se une con `dim_poll_nodes`) |
| `node_type` | String | Tipo de paso: `QUESTION`, `AI_TASK_AUTOMATOR`, `AI_AGENT`, `AI_LEAD_QUALIFICATION`, `AI_OBJECTIVE_AGENT`, `WHATSAPP_FLOW`, `META_EVENTS`, `HELPDESK_INTEGRATION`; vacío cuando el nodo ya no existe |
| `hsm_id` | Int32 | Plantilla HSM enviada en este paso, si aplica; `0` en caso contrario |
| `answer_option_id` | Int32 | La opción predefinida con la que coincidió la respuesta del usuario; `0` para respuestas abiertas |
| `answer_option_text` | String | Etiqueta de esa opción predefinida |
| `response_text` | String | El texto real de la respuesta del usuario |
| `is_timeout` | Bool | `true` si el usuario nunca respondió y el paso agotó el tiempo de espera |
| `entered_at` | DateTime64 | Cuándo se envió este paso al usuario |
| `responded_at` | DateTime64 | Cuándo respondió el usuario; `NULL` si no respondió |
| `question_msg_id` | Int64 | El mensaje que llevó la pregunta (`fact_treble_session_messages.message_id`) |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Funnel de un flujo — alcance por nodo
```sql theme={null}
SELECT
node_id,
any(node_type) AS node_type,
uniqExact(session_id) AS conversations_reached,
countIf(is_timeout) AS timeouts
FROM fact_treble_session_nodes
WHERE poll_id = {your_poll_id}
AND entered_at >= today() - 30
GROUP BY node_id
ORDER BY conversations_reached DESC
```
### Distribución de respuestas de una pregunta
```sql theme={null}
SELECT answer_option_text, count() AS answers
FROM fact_treble_session_nodes
WHERE node_id = {your_node_id}
AND entered_at >= today() - 30
AND responded_at IS NOT NULL
GROUP BY answer_option_text
ORDER BY answers DESC
```
### Conversaciones que usaron IA
```sql theme={null}
SELECT uniqExact(session_id) AS ai_conversations
FROM fact_treble_session_nodes
WHERE node_type LIKE 'AI_%'
AND entered_at >= today() - 7
```
# fact_treble_session_variables
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-treble-session-variables
Variables capturadas o definidas durante cada flujo conversacional.
# fact\_treble\_session\_variables
Cada fila es una variable de un flujo conversacional: datos capturados de las respuestas del usuario, definidos por la lógica del flujo, o recibidos cuando la conversación se creó vía API. Únela con `fact_treble_sessions` a través de `session_id` para agregar contexto de flujo, contacto y resultado.
## ¿Qué preguntas responde?
* ¿Qué valores dieron los usuarios para un campo dado (email, número de orden, ciudad…)?
* ¿Qué sesiones traen una variable dada, y con qué valor?
* ¿Cómo varían los resultados según el valor de una variable (join de vuelta a las sesiones)?
## Columnas
| Columna | Tipo | Descripción |
| ---------------- | ---------- | -------------------------------------------------------- |
| `session_id` | Int64 | El flujo conversacional al que pertenece esta variable |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `variable_name` | String | Nombre de la variable tal como está definida en el flujo |
| `variable_value` | String | Valor actual (gana la última escritura) |
| `created_at` | DateTime64 | Cuándo se definió la variable por primera vez |
| `updated_at` | DateTime64 | Cuándo se actualizó por última vez |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
Cuando un flujo sobrescribe una variable, la fila existente se actualiza en su lugar — ves su valor **más reciente**. En casos raros un flujo registra el mismo nombre de variable como entradas separadas; cuando eso importe, quédate con la fila de mayor `updated_at` (como hace el ejemplo de abajo).
## Consultas de ejemplo
### Pivotear variables a columnas para un flujo
```sql theme={null}
SELECT
session_id,
argMaxIf(variable_value, updated_at, variable_name = 'email') AS email,
argMaxIf(variable_value, updated_at, variable_name = 'order_id') AS order_id
FROM fact_treble_session_variables
WHERE session_id IN (
SELECT session_id FROM fact_treble_sessions
WHERE poll_id = {your_poll_id} AND created_at >= today() - 30
)
GROUP BY session_id
```
### Sesiones según el valor de una variable
```sql theme={null}
SELECT variable_value AS city, count() AS sessions
FROM fact_treble_session_variables
WHERE variable_name = 'city'
AND created_at >= today() - 30
GROUP BY city
ORDER BY sessions DESC
```
# fact_treble_sessions
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-treble-sessions
Una fila por ejecución de flujo conversacional, inbound u outbound.
# fact\_treble\_sessions
Cada fila es una ejecución de un flujo conversacional por un usuario — desde el momento en que comienza (un envío de campaña o un mensaje inbound) hasta el momento en que termina. Es la tabla ancla del warehouse: mensajes, recorridos y variables se unen a ella a través de `session_id`.
## ¿Qué preguntas responde?
* ¿Cuántas conversaciones hubo, inbound vs outbound?
* ¿Qué flujos (`poll_name`) generan más conversaciones?
* ¿Dónde se detienen los usuarios? (`last_node_id`, resoluble contra `dim_poll_nodes`)
* ¿Qué keyword disparó cada conversación inbound?
* ¿Cuánto duran las conversaciones y cómo terminan?
## Columnas
| Columna | Tipo | Descripción |
| ------------------- | ---------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `session_id` | Int64 | Identificador único del flujo conversacional |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `created_at` | DateTime64 | Cuándo comenzó la conversación |
| `cellphone` | String | Número de teléfono del usuario |
| `country_code` | String | Código de país del usuario |
| `status` | String | Quién atendió la conversación: `AI` (se mantuvo en el flujo automatizado), `HumanHandover` (fue transferida a un agente humano), `Rating` (pasó por un agente y llegó al paso de calificación de satisfacción) |
| `is_valid` | Bool | `true` una vez que al menos un mensaje de la conversación fue confirmado como entregado o leído por el usuario — la conversación efectivamente llegó al teléfono |
| `poll_id` | Int32 | Identificador del flujo |
| `poll_name` | String | Nombre del flujo |
| `channel_id` | Int32 | Identificador de la línea de WhatsApp |
| `channel_cellphone` | String | Número de la línea de WhatsApp |
| `direction` | String | `INBOUND` (la inició el usuario) u `OUTBOUND` (la inició una campaña) |
| `contact_id` | Int64 | Contacto de Treble; `0` si no hay |
| `finished_at` | DateTime64 | Cuándo terminó; `NULL` si sigue abierta |
| `trigger_keyword` | String | La keyword que disparó un flujo inbound, cuando alguna coincidió; vacío en caso contrario y para outbound |
| `last_node_id` | Int32 | El último nodo del flujo que alcanzó esta conversación; `0` si nunca alcanzó uno |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### ¿Dónde terminan las conversaciones, por flujo?
```sql theme={null}
SELECT
s.last_node_id,
n.node_type,
n.question_text,
count() AS conversations_ended_here
FROM fact_treble_sessions AS s
LEFT JOIN dim_poll_nodes AS n
ON n.company_id = s.company_id AND n.node_id = s.last_node_id
WHERE s.poll_id = {your_poll_id}
AND s.created_at >= today() - 30
GROUP BY s.last_node_id, n.node_type, n.question_text
ORDER BY conversations_ended_here DESC
```
### Conversaciones inbound por keyword de disparo
```sql theme={null}
SELECT trigger_keyword, count() AS conversations
FROM fact_treble_sessions
WHERE direction = 'INBOUND'
AND created_at >= today() - 7
GROUP BY trigger_keyword
ORDER BY conversations DESC
```
# fact_whatsapp_link_events
Source: https://help.treble.ai/es/docs/data-warehouse-v2/fact-whatsapp-link-events
Eventos de clic y apertura de tus links de WhatsApp de Treble.
# fact\_whatsapp\_link\_events
Cada fila es un evento sobre un link de WhatsApp de Treble (links cortos que abren una conversación de WhatsApp) — tanto la actividad de los usuarios (clics, conversaciones iniciadas) como el ciclo de vida del propio link. Reemplaza a la tabla legacy `fact_whatsapp_links`.
## ¿Qué preguntas responde?
* ¿Cuántos clics recibe cada link, y cuándo?
* ¿Qué links generan más inicios de conversación?
* ¿Cuál es la tasa clic → conversación de cada link?
## Columnas
| Columna | Tipo | Descripción |
| ------------ | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `event_id` | UUID | Identificador único del evento |
| `company_id` | Int32 | Tu empresa (filtrado automáticamente) |
| `link_id` | Int32 | El link de WhatsApp |
| `link_name` | String | Nombre que le diste al link |
| `event_type` | String | Actividad del usuario: `CLICK` (link abierto), `CONVERSATION` (una conversación iniciada desde el link). Ciclo de vida del link: `CREATE`, `UPDATE`, `DELETE` |
| `created_at` | DateTime64 | Cuándo ocurrió el evento |
| `synced_at` | DateTime64 | Cuándo se escribió/corrigió por última vez esta fila |
## Consultas de ejemplo
### Clics y conversaciones por link, últimos 30 días
```sql theme={null}
SELECT
link_name,
countIf(event_type = 'CLICK') AS clicks,
countIf(event_type = 'CONVERSATION') AS conversations,
round(100.0 * conversations / nullIf(clicks, 0), 1) AS conversion_pct
FROM fact_whatsapp_link_events
WHERE created_at >= today() - 30
GROUP BY link_name
ORDER BY clicks DESC
```
# Sincronización Incremental
Source: https://help.treble.ai/es/docs/data-warehouse-v2/incremental-sync
Mantén una copia de tus datos de Treble en tus propios sistemas, de forma confiable, usando el watermark synced_at.
# Sincronizar el warehouse hacia tus propios sistemas
Si te conectas vía JDBC/ODBC para replicar los datos del warehouse en tu propia base de datos o lake, **no necesitas re-descargas completas periódicas**. Todas las tablas exponen `synced_at` — el momento en que cada fila fue escrita o corregida por última vez — diseñado exactamente para la extracción incremental.
## El patrón
Mantén un watermark (`T_prev`) por tabla en tu sistema, y en cada ciclo de sincronización:
```text theme={null}
1. Congela el corte: T = max(synced_at) de la tabla (una consulta, usa NUESTRO reloj)
2. Trae el delta: WHERE synced_at > {T_prev} AND synced_at <= {T}
3. UPSERT por clave: inserta filas nuevas, reemplaza las existentes por su id
4. Refresca la ventana caliente: vuelve a traer los últimos 3 días por fecha de evento
y reemplaza ese segmento completo en tu copia
5. Avanza: T_prev = T (solo después de que los pasos 2–4 hayan tenido éxito)
```
### Por qué importa cada paso
* **Congela `T` una sola vez (paso 1).** Usar `now()` dentro de tus consultas hace que cada página de una extracción larga vea un instante distinto. Congelar un solo timestamp convierte toda la extracción en un snapshot consistente.
* **UPSERT, nunca INSERT ciego (paso 3).** Cuando el warehouse corrige una fila (llega un estado de entrega, aterriza un id de CRM tardío), reemite la **misma clave de negocio** con un `synced_at` nuevo. Un upsert reemplaza tu versión desactualizada; un insert ciego la duplicaría. La clave de cada tabla es su columna `*_id` (`session_id`, `message_id`, `deployment_id`, …).
* **Reemplaza la ventana caliente (paso 4).** En casos raros una fila puede *desaparecer* de una tabla (por ejemplo, un duplicado creado por una corrección interna que se limpia). Una consulta puede devolver lo que existe — no puede decirte qué dejó de existir. Volver a traer una ventana reciente corta por fecha de evento (`created_at` / `scheduled_at`) y reemplazar ese segmento en tu copia garantiza que tus datos coincidan con los nuestros, incluidas las eliminaciones. Tres días es una ventana cómoda; todas las correcciones ocurren dentro de 48 horas.
### Ciclo de referencia (ejemplo: envíos de campaña)
```sql theme={null}
-- paso 1
SELECT max(synced_at) FROM fact_campaign_sends; -- => {T}
-- paso 2 (luego haz UPSERT por deployment_id de tu lado)
SELECT *
FROM fact_campaign_sends
WHERE synced_at > {T_prev} AND synced_at <= {T};
-- paso 4 (reemplaza este segmento completo en tu copia)
SELECT *
FROM fact_campaign_sends
WHERE scheduled_at >= today() - 3 AND synced_at <= {T};
```
## Carga inicial
La primera sincronización es el mismo mecanismo con `T_prev` en cero: trae todo con `synced_at <= T`, en bloques acotados por fecha si la tabla es grande, y luego empieza a ciclar. Sin casos especiales.
## Qué no hacer
* **No re-descargues la historia de forma programada** — los datos consolidados (de más de 48 horas) son inmutables; volver a traerlos es puro costo.
* **No construyas cortes con tu propio reloj** — compara siempre contra valores de `synced_at` leídos del warehouse.
* **No te saltes el upsert** — las correcciones son una característica, no una anomalía; tu copia debe absorberlas.
## Elegir una cadencia
Cualquier cadencia funciona — el watermark hace que los ciclos sean independientes. Cada 15–60 minutos acompaña la frescura propia del warehouse; cada hora o cada día está bien para copias de reporting. El costo de cada ciclo es proporcional a lo que cambió, no al tamaño de tu historia.
# Guía de Migración
Source: https://help.treble.ai/es/docs/data-warehouse-v2/migration-guide
Migra tus queries del Data Warehouse legacy (client_analytics) al Analytics Warehouse.
# Migrar desde el Data Warehouse legacy
El warehouse legacy (`client_analytics`) está **deprecado**. Sigue funcionando, sin cambios, durante el periodo de migración — migras a tu propio ritmo actualizando dos cosas en tus queries: el **nombre de la base de datos** y, donde cambiaron, los **nombres de tablas y columnas**. Tus credenciales y el host de conexión también pueden cambiar; tu Account Manager lo confirmará.
La base de datos legacy `client_analytics` será dada de baja después del periodo de migración. Toda integración nueva debe construirse únicamente contra `treble_client_analytics`.
## Mapeo de tablas
| Legacy (`client_analytics`) | Nueva (`treble_client_analytics`) | Notas |
| ------------------------------------------------------- | ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `fact_sessions` | `fact_treble_sessions` | Agrega `trigger_keyword`, `last_node_id`; `inbound_outbound` → `direction` |
| `fact_inbound_messages` | `fact_treble_sessions` filtrada por `direction = 'INBOUND'` | Absorbida — mismos datos, una sola tabla |
| `fact_deployment_status` | `fact_campaign_sends` | `timestamps_eta` → `scheduled_at`; `timestamp_*` → `*_at` |
| `fact_deployment_daily` | `fact_campaign_daily` | Mismas fórmulas, mismas columnas |
| `fact_conversations` | `fact_agent_conversations` | Historia completa (la legacy mantenía una ventana móvil de 3 meses); agrega transfer\_count, campos de asignación y más |
| `fact_agent_messages` | `fact_agent_conversation_messages` | |
| `fact_redirections` | `fact_agent_conversation_transfers` | |
| `fact_agent_status_changes` | `fact_agent_status_changes` | Mismo nombre |
| `fact_agent_daily` | `fact_agent_daily` | Mismo nombre, mismas fórmulas |
| `fact_hsm_responses` | `fact_hsm_responses` | Mismo nombre |
| `fact_target_events` | `fact_target_events` | Mismo nombre |
| `fact_whatsapp_links` | `fact_whatsapp_link_events` | |
| `dim_agents`, `dim_tags`, `dim_teams`, `dim_agent_tags` | Mismos nombres | |
| `dim_hsm` | `dim_hsms` | Pluralizada |
| `session_variables` | `fact_treble_session_variables` | Ahora disponible de forma general |
| — | `fact_treble_session_messages` | **Nueva** — traza completa de la conversación |
| — | `fact_treble_session_nodes` | **Nueva** — recorrido nodo a nodo |
| — | `fact_ad_sessions` | **Nueva** — atribución Click-to-WhatsApp |
| — | `dim_polls`, `dim_channels`, `dim_poll_nodes` | Dimensiones **nuevas** |
## Renombres de columnas a tener en cuenta
| Legacy | Nueva | Dónde |
| -------------------------------------------------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------- |
| `inbound_outbound` | `direction` | sesiones |
| `campaign_name` | `poll_name` | conversaciones de agente (`poll_name` es el único nombre usado en todas partes ahora) |
| `timestamps_eta` | `scheduled_at` | envíos de campaña |
| `timestamp_delivered` / `_responded` / `_failure` / `_success` | `delivered_at` / `responded_at` / `failed_at` / `succeeded_at` | envíos de campaña |
| `answer_id` | `answer_option_id` | nodos de flujo (identifica la opción elegida) |
## Diferencias de comportamiento que debes conocer
1. **Historia completa.** El warehouse legacy recortaba la mayoría de las tablas a una ventana móvil de 3 meses. El nuevo warehouse sirve todo. Si tus queries dependían de esa ventana como filtro implícito, agrega filtros de fecha explícitos (también es bueno para el rendimiento).
2. **"Hoy" más fresco, consolidación declarada.** Los datos aterrizan en minutos en lugar de horas, y las cifras de un día se consolidan por completo dentro de 48 horas (mira [el contrato de datos](/es/docs/data-warehouse-v2/welcome#el-contrato-de-datos)). Durante una comparación de migración puedes ver el nuevo warehouse ligeramente *adelantado* respecto al legacy en el día más reciente — eso es rezago de actualización del legacy, no una discrepancia.
3. **Los mensajes de conversaciones eliminadas se excluyen** de `fact_agent_conversation_messages` por diseño (la conversación a la que pertenecen ya no existe).
4. **El enriquecimiento de contacto en conversaciones antiguas se congela.** `helpdesk_contact_id` y `contact_wa_id` en conversaciones de agente de más de 90 días conservan el valor que tenían — los cambios del CRM ya no se propagan hacia atrás en ellas.
5. **Dos refinamientos de fórmula documentados** en `fact_agent_daily`: el tiempo de primera respuesta ahora viene del cálculo propio de la plataforma, y los promedios de CSAT consideran solo conversaciones con calificación (`rating != 0`). Ambos son correcciones; la paridad histórica se verificó antes del lanzamiento.
6. **Sin alias.** Los nombres legacy no están espejados en la nueva base de datos — el mapeo de arriba se aplica una sola vez, en tus queries, y ambos sistemas coexisten mientras lo haces.
## Ruta de migración sugerida
1. Apunta una copia de tu dashboard/reporte a `treble_client_analytics` usando el mapeo de arriba.
2. Ejecuta ambas versiones en paralelo durante unos días; espera coincidencias exactas en los días consolidados.
3. Haz el cambio definitivo, manteniendo filtros de fecha explícitos.
4. Avísale a tu Account Manager cuando ya no uses `client_analytics` — nos ayuda a programar la baja definitiva.
# Optimización de Consultas
Source: https://help.treble.ai/es/docs/data-warehouse-v2/query-optimization
Cómo escribir consultas rápidas y eficientes contra el Analytics Warehouse.
# Optimización de Consultas
El Analytics Warehouse corre sobre ClickHouse, una base de datos columnar. Las consultas se comportan distinto que en una base de datos relacional tradicional — unos pocos hábitos las hacen dramáticamente más rápidas.
## Principios clave
### 1. Filtra siempre por fecha
Los datos están organizados físicamente por tiempo. Un filtro de fecha le permite a ClickHouse saltarse bloques enteros de historia sin leerlos — y como el warehouse ahora sirve **historia completa** (no solo 3 meses), los filtros de fecha importan más que nunca.
Cada tabla tiene una columna de tiempo principal por la cual filtrar:
| Tabla | Filtra por |
| ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------- |
| `fact_treble_sessions`, `fact_treble_session_messages`, `fact_treble_session_variables`, `fact_ad_sessions` | `created_at` |
| `fact_treble_session_nodes` | `entered_at` |
| `fact_campaign_sends` | `scheduled_at` |
| `fact_campaign_daily`, `fact_agent_daily` | `day` |
| `fact_agent_conversations`, `fact_agent_conversation_messages`, `fact_agent_conversation_transfers`, `fact_agent_status_changes`, `fact_whatsapp_link_events`, `fact_target_events` | `created_at` |
| `fact_hsm_responses` | `responded_at` |
```sql theme={null}
-- Bien: lee solo el segmento relevante de la historia
SELECT count() FROM fact_treble_sessions
WHERE created_at >= '2026-07-01' AND created_at < '2026-08-01'
-- Mal: escanea la historia completa de la tabla
SELECT count() FROM fact_treble_sessions
WHERE poll_name = 'Welcome flow'
```
### 2. No necesitas filtrar por company\_id
Tu usuario tiene una **row policy** que filtra por tu empresa automáticamente, y los datos están ordenados primero por empresa — todas las consultas se benefician de esto sin que agregues nada.
### 3. Selecciona solo las columnas que necesitas
ClickHouse lee únicamente las columnas que mencionas. Esto importa sobre todo en las columnas de texto anchas (`text`, `content`, `ai_automator_instructions`): dejarlas fuera de un `SELECT` puede reducir el costo de una consulta en un orden de magnitud.
```sql theme={null}
-- Bien: 3 columnas angostas
SELECT session_id, created_at, status
FROM fact_treble_sessions
WHERE created_at >= now() - INTERVAL 7 DAY
-- Evita: SELECT * arrastra todas las columnas anchas
SELECT * FROM fact_treble_session_messages
WHERE created_at >= now() - INTERVAL 7 DAY
```
### 4. Agrega en la base de datos, no en tu herramienta
Trae respuestas, no filas crudas. Un `GROUP BY` sobre millones de filas responde en bastante menos de un segundo; descargar esos millones de filas a una herramienta de BI, no.
### 5. Usa los agregados diarios cuando encajen
[`fact_campaign_daily`](/es/docs/data-warehouse-v2/fact-campaign-daily) y [`fact_agent_daily`](/es/docs/data-warehouse-v2/fact-agent-daily) precalculan las métricas de dashboard más comunes. Un dashboard sobre un agregado lee miles de filas en lugar de millones.
### 6. Usa LIMIT cuando explores
```sql theme={null}
SELECT * FROM fact_treble_session_messages
WHERE created_at >= now() - INTERVAL 1 DAY
ORDER BY created_at DESC
LIMIT 100
```
## Consejos para JOINs
* **Une por ids, no por nombres**: `session_id`, `agent_conversation_id`, `hsm_id` — los nombres son para mostrar.
* **Pon la tabla pequeña en el lado derecho** del JOIN — ClickHouse carga el lado derecho en memoria. Las dimensiones siempre son pequeñas; unir dos tablas de hechos grandes funciona mejor cuando ambos lados traen un filtro de fecha.
* **Incluye `company_id` en la clave del join** al unir hechos con dimensiones (como hacen los ejemplos de esta documentación).
```sql theme={null}
-- Sesiones enriquecidas con el nombre visible del canal
SELECT s.poll_name, c.display_name, count() AS sessions
FROM fact_treble_sessions AS s
LEFT JOIN dim_channels AS c
ON c.company_id = s.company_id AND c.channel_id = s.channel_id
WHERE s.created_at >= today() - 30
GROUP BY s.poll_name, c.display_name
```
## Límites del sistema
Tu usuario corre con límites de protección que mantienen la plataforma estable para todos:
| Límite | Valor |
| -------------------------------------- | ----------- |
| Tiempo máximo de ejecución | 30 segundos |
| Máximo de filas leídas | 50 millones |
| Máximo de bytes leídos | 5 GB |
| Máximo de filas en el resultado | 500,000 |
| Memoria máxima por consulta | 2 GB |
| Máximo de columnas leídas por consulta | 50 |
Si un límite cancela una consulta:
* Agrega o ajusta el filtro de fecha (la solución en casi todos los casos)
* Elimina columnas innecesarias — especialmente las columnas de texto anchas
* Agrega con `GROUP BY` en lugar de traer filas crudas
* Divide las extracciones muy grandes en bloques de un mes (mira [Sincronización Incremental](/es/docs/data-warehouse-v2/incremental-sync) para el patrón que evita las extracciones grandes por completo)
# Analytics Warehouse
Source: https://help.treble.ai/es/docs/data-warehouse-v2/welcome
Consulta tus datos de Treble casi en tiempo real con SQL — historia completa, mayor detalle y un contrato de nombres estable.
# Analytics Warehouse
El Analytics Warehouse es la nueva generación de la plataforma de datos de Treble. Te da acceso SQL directo a tus datos operacionales con **frescura casi en tiempo real**, **historia completa** y varios datasets que antes no estaban disponibles — incluyendo la traza completa de mensajes de cada conversación y el recorrido nodo a nodo de cada flujo.
El Analytics Warehouse reemplaza al Data Warehouse anterior (`client_analytics`), que ahora está **deprecado**. Ambos permanecen disponibles durante el periodo de migración. Si estás migrando queries existentes, comienza por la [Guía de Migración](/es/docs/data-warehouse-v2/migration-guide).
## ¿Qué hay de nuevo?
| | Warehouse anterior | Analytics Warehouse |
| ------------------------------ | ------------------ | ----------------------------------- |
| **Frescura** | Hasta 3 horas | **\~15 minutos** |
| **Historia** | Últimos 3 meses | **Historia completa** |
| **Mensajes de conversaciones** | No disponible | Traza completa, mensaje a mensaje |
| **Recorrido por el flujo** | No disponible | Paso a paso, incluyendo pasos de IA |
| **Variables de sesión** | No disponible | Disponible |
| **Atribución de anuncios** | No disponible | Anuncio Click-to-WhatsApp → sesión |
| **Sincronización incremental** | No soportada | Watermark `synced_at` en cada fila |
## Conexión
Una vez habilitado el acceso, recibirás credenciales para conectarte:
| Parámetro | Valor |
| ----------------- | ------------------------------------ |
| **Host** | Proporcionado por Treble |
| **Puerto** | `8443` (HTTPS) / `9440` (Native TLS) |
| **Base de datos** | `treble_client_analytics` |
| **Usuario** | Proporcionado por Treble |
| **Contraseña** | Proporcionada por Treble |
Puedes usar cualquier cliente compatible con ClickHouse: DBeaver, DataGrip, `clickhouse-client`, o conectar directamente desde Metabase, Looker, Power BI, Google Sheets u otra herramienta de BI.
El acceso está disponible para empresas que soliciten el onboarding. Contacta a tu Account Manager o a soporte para iniciar el proceso.
## El contrato de datos
Tres promesas definen cómo se comporta el warehouse. Entenderlas te ahorrará tiempo:
1. **Los datos son casi en tiempo real.** Las sesiones, mensajes y envíos de campaña nuevos aparecen a los pocos minutos de ocurrir.
2. **Hoy es provisional; la historia es definitiva.** Los datos operacionales siguen cambiando mientras están en curso — un envío de campaña que está "en proceso" a las 10:00 puede estar "entregado" a las 11:00, tanto en Treble como en tu warehouse. Las cifras de cualquier día **se consolidan por completo dentro de 48 horas**, y el warehouse se autocorrige continuamente (cada 30 minutos) durante esa ventana. Los datos históricos más allá de esa ventana son inmutables.
3. **Cada fila te dice cuándo llegó.** Todas las tablas exponen una columna `synced_at`: el momento en que la fila (o su última corrección) fue escrita. Esto habilita la [sincronización incremental](/es/docs/data-warehouse-v2/incremental-sync) confiable hacia tus propios sistemas.
## Glosario de nombres
El warehouse usa un mismo vocabulario consistente en todas las tablas:
| Término | Significado |
| ----------------------- | ------------------------------------------------------------------------------------ |
| `poll_id` / `poll_name` | Un flujo conversacional (lo que construyes en el editor de flujos de Treble). |
| `session_id` | Una ejecución de un flujo por un usuario — una conversación. |
| `direction` | `INBOUND` si el usuario inició la conversación, `OUTBOUND` si la inició una campaña. |
| `agent_conversation_id` | Una conversación atendida en el espacio de trabajo de agentes (Sales). |
| `treble_id` | La identidad telefónica del contacto: código de país + celular. |
| `synced_at` | Cuándo se escribió o corrigió por última vez esta fila en el warehouse. |
## Seguridad y límites
* **Seguridad a nivel de fila:** tus credenciales solo pueden ver las filas de tu empresa — lo garantiza la base de datos en cada tabla y en cada consulta.
* **Solo lectura:** tu usuario no puede modificar, crear ni eliminar nada.
* **Límites de protección:** las consultas tienen un tope de ejecución de 30 segundos y límites de filas y memoria que mantienen la plataforma estable para todos. Revisa [Optimización de Consultas](/es/docs/data-warehouse-v2/query-optimization) para mantenerte holgadamente dentro de ellos.
## Tablas disponibles
### Flujos Conversacionales
Todo lo que ocurre dentro de tus flujos automatizados.
| Tabla | Granularidad | ¿Qué contiene? |
| ------------------------------------------------------------------------------------------- | ------------------------------- | ------------------------------------------------------------------ |
| [`fact_treble_sessions`](/es/docs/data-warehouse-v2/fact-treble-sessions) | 1 fila por flujo conversacional | Cada ejecución de un flujo, inbound y outbound |
| [`fact_treble_session_messages`](/es/docs/data-warehouse-v2/fact-treble-session-messages) | 1 fila por mensaje | La traza completa de la conversación |
| [`fact_treble_session_nodes`](/es/docs/data-warehouse-v2/fact-treble-session-nodes) | 1 fila por paso interactivo | El recorrido por el flujo — preguntas, pasos de IA, WhatsApp Flows |
| [`fact_treble_session_variables`](/es/docs/data-warehouse-v2/fact-treble-session-variables) | 1 fila por variable | Variables capturadas durante cada flujo |
### Campañas
Envíos outbound y cómo interactúan los usuarios con ellos.
| Tabla | Granularidad | ¿Qué contiene? |
| ----------------------------------------------------------------------- | -------------------------- | -------------------------------------------------------------------- |
| [`fact_campaign_sends`](/es/docs/data-warehouse-v2/fact-campaign-sends) | 1 fila por envío | Cada mensaje outbound de campaña, con el detalle completo de entrega |
| [`fact_campaign_daily`](/es/docs/data-warehouse-v2/fact-campaign-daily) | 1 fila por campaña por día | Agregado diario de entregas |
| [`fact_hsm_responses`](/es/docs/data-warehouse-v2/fact-hsm-responses) | 1 fila por respuesta | Respuestas dadas a las plantillas HSM |
### Espacio de Trabajo de Agentes
Operación de agentes humanos: conversaciones, mensajes, transferencias, disponibilidad, productividad.
| Tabla | Granularidad | ¿Qué contiene? |
| --------------------------------------------------------------------------------------------------- | --------------------------------- | ------------------------------------------------------------ |
| [`fact_agent_conversations`](/es/docs/data-warehouse-v2/fact-agent-conversations) | 1 fila por conversación de agente | Conversaciones atendidas en el espacio de trabajo de agentes |
| [`fact_agent_conversation_messages`](/es/docs/data-warehouse-v2/fact-agent-conversation-messages) | 1 fila por mensaje | Mensajes dentro de las conversaciones de agente |
| [`fact_agent_conversation_transfers`](/es/docs/data-warehouse-v2/fact-agent-conversation-transfers) | 1 fila por transferencia | Transferencias entre agentes |
| [`fact_agent_status_changes`](/es/docs/data-warehouse-v2/fact-agent-status-changes) | 1 fila por cambio | Historial de disponibilidad de los agentes |
| [`fact_agent_daily`](/es/docs/data-warehouse-v2/fact-agent-daily) | 1 fila por agente por día | Productividad diaria por agente |
### Conversiones y Atribución
De dónde vienen las conversaciones y qué logran.
| Tabla | Granularidad | ¿Qué contiene? |
| ----------------------------------------------------------------------------------- | ---------------------------------------- | ------------------------------------------------------- |
| [`fact_target_events`](/es/docs/data-warehouse-v2/fact-target-events) | 1 fila por evento | Eventos de conversión/objetivo disparados en los flujos |
| [`fact_ad_sessions`](/es/docs/data-warehouse-v2/fact-ad-sessions) | 1 fila por sesión atribuida a un anuncio | Atribución de anuncios Click-to-WhatsApp |
| [`fact_whatsapp_link_events`](/es/docs/data-warehouse-v2/fact-whatsapp-link-events) | 1 fila por evento | Clics en links de WhatsApp e inicios de conversación |
### Dimensiones — catálogos para enriquecer
Agentes, tags, equipos, plantillas HSM, asignaciones agente-tag, flujos (polls), canales de WhatsApp y nodos de flujo (incluyendo la configuración de agentes de IA). Consulta [Dimensiones](/es/docs/data-warehouse-v2/dimensions).
# Tablas de Dimensiones
Source: https://help.treble.ai/es/docs/data-warehouse/dimensions
Tablas de referencia: agentes, equipos, tags, plantillas HSM.
# Tablas de Dimensiones
Las dimensiones contienen información de referencia que puedes cruzar con las tablas de hechos usando JOINs. Se actualizan con mayor frecuencia (cada 10 minutos).
***
## dim\_agents
Información de cada agente registrado en la plataforma.
| Columna | Tipo | Descripción |
| ------------ | ------ | -------------------------------------- |
| `id` | Int32 | Identificador del agente |
| `company_id` | Int32 | Identificador de la empresa |
| `first_name` | String | Nombre |
| `last_name` | String | Apellido |
| `email` | String | Correo electrónico |
| `active` | Bool | Si el agente está activo |
| `agent_type` | String | Tipo de agente: `admin`, `agent`, etc. |
***
## dim\_tags
Colas o tags usados para enrutar conversaciones a grupos de agentes.
| Columna | Tipo | Descripción |
| ------------ | ------ | ----------------------------------------------- |
| `id` | Int32 | Identificador del tag |
| `company_id` | Int32 | Identificador de la empresa |
| `name` | String | Nombre del tag |
| `team_id` | Int32 | Equipo al que pertenece. `0` si no tiene equipo |
***
## dim\_teams
Equipos de trabajo que agrupan tags.
| Columna | Tipo | Descripción |
| ------------ | ------ | --------------------------- |
| `id` | Int32 | Identificador del equipo |
| `company_id` | Int32 | Identificador de la empresa |
| `name` | String | Nombre del equipo |
***
## dim\_hsm
Plantillas HSM (templates de WhatsApp) aprobadas por Meta.
| Columna | Tipo | Descripción |
| --------------- | ------ | -------------------------------------------- |
| `id` | Int32 | Identificador de la plantilla |
| `company_id` | Int32 | Identificador de la empresa |
| `name` | String | Nombre de la plantilla |
| `status` | String | Estado: `APPROVED`, `REJECTED`, `PROCESSING` |
| `category` | String | Categoría de la plantilla |
| `template_type` | String | Tipo de plantilla |
| `content` | String | Contenido de la plantilla |
| `provider_id` | String | ID de la plantilla en Meta |
***
## dim\_agent\_tags
Relación entre agentes, tags y equipos. Un agente puede pertenecer a múltiples tags.
| Columna | Tipo | Descripción |
| ------------ | ------ | --------------------------- |
| `agent_id` | Int32 | Identificador del agente |
| `company_id` | Int32 | Identificador de la empresa |
| `tag_id` | Int32 | Identificador del tag |
| `tag_name` | String | Nombre del tag |
| `team_id` | Int32 | Identificador del equipo |
| `team_name` | String | Nombre del equipo |
### Ejemplo: agentes con su equipo
```sql theme={null}
SELECT
a.first_name,
a.last_name,
at.tag_name,
at.team_name
FROM client_analytics.dim_agents a
INNER JOIN client_analytics.dim_agent_tags at ON at.agent_id = a.id
WHERE a.active = true
ORDER BY at.team_name, a.first_name
```
# fact_agent_daily
Source: https://help.treble.ai/es/docs/data-warehouse/fact-agent-daily
Métricas de productividad pre-agregadas por agente por día.
# fact\_agent\_daily
Tabla pre-agregada con las métricas principales de productividad de cada agente por día. Útil para reportes ejecutivos sin necesidad de escribir consultas complejas.
## ¿Qué preguntas responde?
* ¿Cuántas conversaciones atendió cada agente por día?
* ¿Cuál fue el tiempo promedio de primera respuesta?
* ¿Cuántos mensajes envió cada agente?
* ¿Cuánto tiempo estuvo disponible cada agente?
* ¿Cuál fue la calificación promedio (CSAT)?
## Columnas
| Columna | Tipo | Descripción |
| ---------------------------- | ---------- | --------------------------------------------------------------------------- |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `agent_id` | Int32 | Identificador del agente |
| `day` | Date | Día calendario |
| `agent_name` | String | Nombre completo del agente |
| `chats_handled` | UInt32 | Conversaciones atendidas (agente envió al menos 1 mensaje) |
| `chats_resolved` | UInt32 | Conversaciones cerradas |
| `chats_transferred_sent` | UInt32 | Transferencias enviadas por el agente |
| `chats_transferred_received` | UInt32 | Transferencias recibidas por el agente |
| `messages_sent` | UInt32 | Total de mensajes enviados por el agente |
| `hsm_messages_sent` | UInt32 | Mensajes de plantilla (HSM) enviados |
| `first_message_at` | DateTime64 | Primer mensaje del agente en el día. `NULL` si no envió mensajes |
| `last_message_at` | DateTime64 | Último mensaje del agente en el día |
| `avg_first_response_sec` | Float64 | Tiempo promedio de primera respuesta (en segundos). `0` si no aplica |
| `avg_response_time_sec` | Float64 | Tiempo promedio de respuesta entre mensajes (en segundos). `0` si no aplica |
| `avg_resolution_min` | Float64 | Tiempo promedio de resolución (en minutos). `0` si no cerró conversaciones |
| `csat_avg` | Float64 | Calificación promedio (CSAT). `0` si no hubo calificaciones |
| `service_level_pct` | Float64 | Porcentaje de conversaciones con primera respuesta en menos de 120 segundos |
| `available_minutes` | Float64 | Minutos que el agente estuvo online en el día |
Para obtener el equipo del agente, cruza esta tabla con `dim_agent_tags` usando `agent_id`.
## Consultas de ejemplo
### Productividad semanal por agente
```sql theme={null}
SELECT
agent_name,
sum(chats_handled) AS chats_totales,
sum(messages_sent) AS mensajes_totales,
round(avg(avg_first_response_sec), 0) AS primera_respuesta_seg,
round(avg(service_level_pct) * 100, 1) AS nivel_servicio_pct,
round(sum(available_minutes) / 60, 1) AS horas_disponible
FROM client_analytics.fact_agent_daily
WHERE day >= today() - 7
GROUP BY agent_name
ORDER BY chats_totales DESC
```
### Productividad por equipo
```sql theme={null}
SELECT
at.team_name,
sum(ad.chats_handled) AS chats_totales,
round(avg(ad.csat_avg), 2) AS csat_promedio
FROM client_analytics.fact_agent_daily ad
INNER JOIN client_analytics.dim_agent_tags at ON at.agent_id = ad.agent_id
WHERE ad.day >= today() - 30
GROUP BY at.team_name
ORDER BY chats_totales DESC
```
# fact_agent_messages
Source: https://help.treble.ai/es/docs/data-warehouse/fact-agent-messages
Una fila por cada mensaje en una conversación de agentes.
# fact\_agent\_messages
Cada fila representa un mensaje individual dentro de una conversación de agentes. Incluye el contenido, quién lo envió, y los estados de entrega y lectura.
## ¿Qué preguntas responde?
* ¿Qué mensajes se enviaron en cada conversación?
* ¿Quién envió cada mensaje (agente o usuario)?
* ¿Cuántos mensajes envía cada agente por día?
* ¿Cuál fue el tiempo de respuesta del agente?
* ¿Los mensajes fueron leídos?
## Columnas
| Columna | Tipo | Descripción |
| ----------------------- | ---------- | -------------------------------------------------------------------------- |
| `message_id` | Int32 | Identificador único del mensaje |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `conversation_id` | Int32 | Conversación a la que pertenece el mensaje |
| `survey_user_id` | Int64 | Identificador del flujo de conversación asociado. `0` si no tiene |
| `created_at` | DateTime64 | Fecha y hora del mensaje |
| `sender` | String | Quién envió el mensaje: `AGENT`, `USER`, `SYSTEM` |
| `category` | String | Tipo de contenido: `text`, `image`, `video`, `audio`, `document`, `hsm` |
| `content` | String | Contenido del mensaje en formato JSON |
| `agent_id` | Int32 | Identificador del agente que envió (si `sender = AGENT`). `0` si no aplica |
| `agent_name` | String | Nombre del agente |
| `team_name` | String | Equipo del agente |
| `read_at` | DateTime64 | Fecha de lectura. `NULL` si no fue leído |
| `delivered_at` | DateTime64 | Fecha de entrega. `NULL` si no fue entregado |
| `reply_provider_msg_id` | String | ID del mensaje al que se respondió (si es una respuesta) |
| `reaction` | String | Reacción al mensaje (emoji) |
## Consultas de ejemplo
### Mensajes por agente en los últimos 7 días
```sql theme={null}
SELECT
agent_name,
count() AS mensajes_enviados,
countIf(category = 'hsm') AS plantillas_enviadas
FROM client_analytics.fact_agent_messages
WHERE created_at >= now() - INTERVAL 7 DAY
AND sender = 'AGENT'
GROUP BY agent_name
ORDER BY mensajes_enviados DESC
```
### Tiempo de primera respuesta por conversación
```sql theme={null}
SELECT
conversation_id,
min(created_at) AS primera_respuesta_agente
FROM client_analytics.fact_agent_messages
WHERE sender = 'AGENT'
AND created_at >= now() - INTERVAL 7 DAY
GROUP BY conversation_id
```
### Contenido de mensajes de una conversación específica
```sql theme={null}
SELECT
created_at,
sender,
agent_name,
category,
content
FROM client_analytics.fact_agent_messages
WHERE conversation_id = 12345
ORDER BY created_at
```
# fact_agent_status_changes
Source: https://help.treble.ai/es/docs/data-warehouse/fact-agent-status-changes
Una fila por cada cambio de estado online/offline de un agente.
# fact\_agent\_status\_changes
Cada fila representa un cambio de estado (online/offline) de un agente en la plataforma de agentes.
## ¿Qué preguntas responde?
* ¿Cuándo se conectaron y desconectaron los agentes?
* ¿Cuántas horas estuvo disponible cada agente?
* ¿Cuál fue el horario de conexión de cada agente?
## Columnas
| Columna | Tipo | Descripción |
| ------------------ | ---------- | ---------------------------------------------------------------------------------- |
| `status_change_id` | Int32 | Identificador único del evento |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `agent_id` | Int32 | Identificador del agente |
| `agent_name` | String | Nombre del agente |
| `created_at` | DateTime64 | Fecha y hora del cambio de estado |
| `old_status` | Bool | Estado anterior. `true` = online, `false` = offline. `NULL` si es el primer evento |
| `new_status` | Bool | Nuevo estado. `true` = online, `false` = offline |
## Consultas de ejemplo
### Horarios de conexión de agentes hoy
```sql theme={null}
SELECT
agent_name,
created_at,
if(new_status, 'online', 'offline') AS estado
FROM client_analytics.fact_agent_status_changes
WHERE created_at >= today()
ORDER BY agent_name, created_at
```
### Minutos online por agente por día
```sql theme={null}
SELECT
agent_name,
toDate(created_at) AS dia,
round(sum(if(new_status = true,
dateDiff('minute', created_at,
leadInFrame(created_at) OVER (PARTITION BY agent_id ORDER BY created_at)
), 0)) / 60, 1) AS horas_online
FROM client_analytics.fact_agent_status_changes
WHERE created_at >= now() - INTERVAL 7 DAY
GROUP BY agent_name, dia
ORDER BY dia DESC, agent_name
```
# fact_conversations
Source: https://help.treble.ai/es/docs/data-warehouse/fact-conversations
Una fila por cada conversación atendida por un agente.
# fact\_conversations
Cada fila representa una conversación en la plataforma de agentes. Incluye información del agente que la atendió, el equipo, el estado final y datos del flujo de conversación asociado.
## ¿Qué preguntas responde?
* ¿Cuántas conversaciones se atendieron en un período?
* ¿Qué agente atendió cada conversación?
* ¿Cuánto tiempo tomó resolver una conversación?
* ¿Cuántas conversaciones fueron inbound vs outbound?
* ¿Cuántas transferencias tuvo cada conversación?
* ¿Cuál fue la calificación (rating) del usuario?
## Columnas
| Columna | Tipo | Descripción |
| ------------------------ | ---------- | ---------------------------------------------------------------------------------------------------- |
| `conversation_id` | Int32 | Identificador único de la conversación |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `survey_user_id` | Int64 | Identificador del flujo de conversación asociado. `0` si no tiene flujo vinculado |
| `contact_id` | Int32 | Identificador del contacto en la plataforma de agentes |
| `created_at` | DateTime64 | Fecha y hora de creación de la conversación |
| `finished_at` | DateTime64 | Fecha y hora de cierre. `NULL` si sigue abierta |
| `assigned_at` | DateTime64 | Fecha y hora de asignación al agente. `NULL` si no fue asignada |
| `status` | String | Estado actual: `OPEN`, `CLOSED`, `PENDING`, etc. |
| `finish_type` | String | Cómo se cerró: `AGENT`, `SYSTEM`, `TIMEOUT`, etc. |
| `rating` | Int32 | Calificación del usuario (1-5). `0` si no calificó |
| `is_redirected` | Bool | `true` si la conversación fue transferida al menos una vez |
| `agent_id` | Int32 | Identificador del agente que atendió. `0` si no fue asignada |
| `agent_name` | String | Nombre completo del agente |
| `tag_id` | Int32 | Identificador del tag/cola asignado |
| `tag_name` | String | Nombre del tag/cola |
| `team_id` | Int32 | Identificador del equipo |
| `team_name` | String | Nombre del equipo |
| `channel_id` | Int32 | Identificador del canal (línea de WhatsApp) |
| `inbound_outbound` | String | `inbound` si el usuario inició la conversación, `outbound` si fue iniciada por campaña |
| `campaign_name` | String | Nombre de la campaña asociada |
| `transfer_count` | UInt32 | Número de transferencias que tuvo la conversación |
| `first_agent_message_at` | DateTime64 | Fecha del primer mensaje del agente. `NULL` si el agente no respondió |
| `first_response_sec` | Int32 | Segundos entre la creación de la conversación y el primer mensaje del agente. `NULL` si no respondió |
| `helpdesk_contact_id` | String | Identificador del contacto en el CRM externo (si existe integración) |
| `contact_wa_id` | String | Número de WhatsApp del contacto |
## Consultas de ejemplo
### Conversaciones por agente en los últimos 30 días
```sql theme={null}
SELECT
agent_name,
count() AS total_conversaciones,
countIf(status = 'CLOSED') AS cerradas,
round(avg(if(finished_at IS NOT NULL,
dateDiff('minute', created_at, finished_at), NULL)), 1) AS tiempo_resolucion_min_promedio
FROM client_analytics.fact_conversations
WHERE created_at >= now() - INTERVAL 30 DAY
GROUP BY agent_name
ORDER BY total_conversaciones DESC
```
### Nivel de servicio por equipo (SLA personalizable)
```sql theme={null}
SELECT
team_name,
count() AS conversaciones,
-- Puedes cambiar 120 por el umbral que necesites (en segundos)
round(countIf(first_response_sec <= 120) * 100.0 / count(), 1) AS sla_120s_pct,
round(countIf(first_response_sec <= 60) * 100.0 / count(), 1) AS sla_60s_pct,
round(avg(first_response_sec), 0) AS promedio_respuesta_seg
FROM client_analytics.fact_conversations
WHERE created_at >= now() - INTERVAL 7 DAY
AND first_response_sec IS NOT NULL
GROUP BY team_name
ORDER BY sla_120s_pct DESC
```
### Conversaciones inbound vs outbound por día
```sql theme={null}
SELECT
toDate(created_at) AS dia,
inbound_outbound,
count() AS total
FROM client_analytics.fact_conversations
WHERE created_at >= now() - INTERVAL 30 DAY
GROUP BY dia, inbound_outbound
ORDER BY dia DESC
```
# fact_deployment_daily
Source: https://help.treble.ai/es/docs/data-warehouse/fact-deployment-daily
Métricas de envío pre-agregadas por campaña por día.
# fact\_deployment\_daily
Tabla pre-agregada con conteos de envíos por campaña y día, desglosados por estado. Ideal para dashboards de métricas generales sin necesidad de agregar sobre la tabla de detalle.
## ¿Qué preguntas responde?
* ¿Cuántos envíos se hicieron por campaña por día?
* ¿Cuál fue la tasa de entrega y respuesta?
* ¿Cuántos fallos hubo y de qué tipo?
* ¿Cuántos usuarios pasaron a hablar con un agente?
## Columnas
| Columna | Tipo | Descripción |
| --------------------------- | ------- | ------------------------------------------------------ |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `day` | Date | Día calendario |
| `poll_id` | Int32 | Identificador de la campaña |
| `poll_name` | String | Nombre de la campaña |
| `sent` | UInt32 | Total de envíos |
| `delivered` | UInt32 | Entregados al usuario |
| `responded` | UInt32 | Respondidos por el usuario |
| `failure` | UInt32 | Fallidos |
| `in_process` | UInt32 | En proceso |
| `failure_rate_limit` | UInt32 | Fallidos por límite de tasa |
| `revoked` | UInt32 | Revocados |
| `invalid_phone` | UInt32 | Teléfono inválido |
| `missing_parameter` | UInt32 | Parámetro faltante |
| `failure_human_handover` | UInt32 | Fallo por conversación activa con agente |
| `deactivated_poll_or_hsm` | UInt32 | Campaña o plantilla desactivada |
| `failure_general` | UInt32 | Fallo general |
| `failure_unable_to_contact` | UInt32 | No se pudo contactar |
| `optout` | UInt32 | Usuario optó por no recibir mensajes |
| `meta_chose_not_deliver` | UInt32 | Meta decidió no entregar |
| `to_agents` | UInt32 | Usuarios que pasaron a agente |
| `delivered_rate_pct` | Float64 | Tasa de entrega (%) |
| `response_rate_pct` | Float64 | Tasa de respuesta (%) |
## Consultas de ejemplo
### Resumen de las últimas 2 semanas
```sql theme={null}
SELECT
poll_name,
sum(sent) AS enviados,
sum(delivered) AS entregados,
sum(responded) AS respondidos,
sum(to_agents) AS pasaron_a_agente,
round(sum(delivered) * 100.0 / nullIf(sum(sent), 0), 1) AS tasa_entrega_pct
FROM client_analytics.fact_deployment_daily
WHERE day >= today() - 14
GROUP BY poll_name
ORDER BY enviados DESC
```
# fact_deployment_status
Source: https://help.treble.ai/es/docs/data-warehouse/fact-deployment-status
Una fila por cada envío outbound (intento de entrega).
# fact\_deployment\_status
Cada fila representa un intento de envío outbound a un usuario. Incluye el estado de entrega, la campaña y los timestamps de cada etapa.
## ¿Qué preguntas responde?
* ¿Cuántos envíos se hicieron por campaña?
* ¿Cuáles fueron entregados, fallidos, respondidos?
* ¿Cuál fue la tasa de entrega?
* ¿A qué números se envió?
## Columnas
| Columna | Tipo | Descripción |
| --------------------- | ---------- | -------------------------------------------------------------------- |
| `deployment_id` | String | Identificador único del envío |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `timestamps_eta` | DateTime64 | Fecha y hora programada del envío |
| `cellphone` | String | Número de celular destino |
| `country_code` | String | Código de país |
| `status` | String | Estado del envío: `DELIVERED`, `FAILURE`, `SUCCESS`, `REVOKED`, etc. |
| `poll_id` | Int32 | Identificador de la campaña |
| `poll_name` | String | Nombre de la campaña |
| `origin` | String | Origen del envío: `API`, `PLATFORM`, etc. |
| `origin_id` | Int32 | Identificador del origen |
| `timestamp_delivered` | DateTime64 | Fecha de entrega al usuario |
| `timestamp_responded` | DateTime64 | Fecha de respuesta del usuario |
| `timestamp_failure` | DateTime64 | Fecha de fallo (si falló) |
| `batch_id` | String | Identificador del lote de envío |
| `treble_id` | String | Identificador único del contacto en Treble |
## Consultas de ejemplo
### Tasa de entrega por campaña
```sql theme={null}
SELECT
poll_name,
count() AS enviados,
countIf(timestamp_delivered > '2000-01-01') AS entregados,
countIf(timestamp_responded > '2000-01-01') AS respondidos,
round(countIf(timestamp_delivered > '2000-01-01') * 100.0 / count(), 1) AS tasa_entrega_pct,
round(countIf(timestamp_responded > '2000-01-01') * 100.0
/ nullIf(countIf(timestamp_delivered > '2000-01-01'), 0), 1) AS tasa_respuesta_pct
FROM client_analytics.fact_deployment_status
WHERE timestamps_eta >= now() - INTERVAL 30 DAY
GROUP BY poll_name
ORDER BY enviados DESC
```
# fact_hsm_responses
Source: https://help.treble.ai/es/docs/data-warehouse/fact-hsm-responses
Una fila por cada respuesta de usuario a una plantilla HSM.
# fact\_hsm\_responses
Cada fila representa la respuesta de un usuario a un nodo de plantilla HSM (template de WhatsApp) dentro de un flujo de conversación.
## ¿Qué preguntas responde?
* ¿Qué respondieron los usuarios a cada plantilla HSM?
* ¿Cuántas respuestas tuvo cada plantilla?
* ¿Cuál fue la tasa de respuesta por campaña?
## Columnas
| Columna | Tipo | Descripción |
| ----------------------- | ---------- | ------------------------------------------------------ |
| `interaction_answer_id` | Int64 | Identificador único de la respuesta |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `survey_user_id` | Int64 | Identificador del flujo de conversación asociado |
| `question_id` | Int32 | Identificador de la pregunta |
| `hsm_id` | Int32 | Identificador de la plantilla HSM |
| `hsm_name` | String | Nombre de la plantilla HSM |
| `answer_text` | String | Texto de la respuesta del usuario |
| `response_date` | DateTime64 | Fecha y hora de la respuesta |
| `poll_id` | Int32 | Identificador de la campaña |
| `cellphone` | String | Número de celular del usuario |
## Consultas de ejemplo
### Respuestas por plantilla HSM
```sql theme={null}
SELECT
hsm_name,
count() AS total_respuestas,
count(DISTINCT survey_user_id) AS usuarios_unicos
FROM client_analytics.fact_hsm_responses
WHERE response_date >= now() - INTERVAL 30 DAY
GROUP BY hsm_name
ORDER BY total_respuestas DESC
```
### Respuestas de una plantilla específica
```sql theme={null}
SELECT
response_date,
cellphone,
answer_text
FROM client_analytics.fact_hsm_responses
WHERE hsm_name = 'mi_plantilla'
AND response_date >= now() - INTERVAL 7 DAY
ORDER BY response_date DESC
LIMIT 100
```
# fact_redirections
Source: https://help.treble.ai/es/docs/data-warehouse/fact-redirections
Una fila por cada transferencia entre agentes.
# fact\_redirections
Cada fila representa una transferencia de una conversación de un agente a otro.
## ¿Qué preguntas responde?
* ¿Cuántas transferencias hubo en un período?
* ¿Qué agentes transfieren más conversaciones?
* ¿A qué agentes se les transfieren más conversaciones?
## Columnas
| Columna | Tipo | Descripción |
| ----------------- | ---------- | ------------------------------------------------------ |
| `redirection_id` | Int32 | Identificador único de la transferencia |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `conversation_id` | Int32 | Conversación transferida |
| `survey_user_id` | Int64 | Identificador del flujo de conversación asociado |
| `created_at` | DateTime64 | Fecha y hora de la transferencia |
| `from_agent_id` | Int32 | Agente que transfirió |
| `from_agent_name` | String | Nombre del agente que transfirió |
| `to_agent_id` | Int32 | Agente que recibió |
| `to_agent_name` | String | Nombre del agente que recibió |
| `team_name` | String | Equipo de la conversación |
## Consultas de ejemplo
### Transferencias por agente origen
```sql theme={null}
SELECT
from_agent_name,
count() AS transferencias_enviadas
FROM client_analytics.fact_redirections
WHERE created_at >= now() - INTERVAL 30 DAY
GROUP BY from_agent_name
ORDER BY transferencias_enviadas DESC
```
# fact_sessions
Source: https://help.treble.ai/es/docs/data-warehouse/fact-sessions
Una fila por cada flujo de conversación ejecutado.
# fact\_sessions
Cada fila representa un flujo de conversación ejecutado (inbound o outbound). Un flujo de conversación es la interacción completa de un usuario con un flujo de Treble, desde que inicia hasta que finaliza.
## ¿Qué preguntas responde?
* ¿Cuántos flujos de conversación se ejecutaron?
* ¿Cuántos fueron inbound y cuántos outbound?
* ¿Qué campañas generaron más flujos?
* ¿Cuál fue el estado final de cada flujo?
* ¿Qué línea de WhatsApp se usó?
## Columnas
| Columna | Tipo | Descripción |
| ------------------- | ---------- | ----------------------------------------------------------------------- |
| `session_id` | Int64 | Identificador único del flujo de conversación |
| `company_id` | Int32 | Identificador de la empresa (filtrado automáticamente) |
| `created_at` | DateTime64 | Fecha y hora de inicio |
| `cellphone` | String | Número de celular del usuario |
| `country_code` | String | Código de país del usuario |
| `status` | String | Estado final del flujo: `HumanHandover`, `Rating`, `Finished`, etc. |
| `is_valid` | Bool | Si el flujo se completó correctamente |
| `poll_id` | Int32 | Identificador de la campaña/conversación |
| `poll_name` | String | Nombre de la campaña |
| `channel_id` | Int32 | Identificador de la línea de WhatsApp |
| `channel_cellphone` | String | Número de la línea de WhatsApp |
| `inbound_outbound` | String | `INBOUND` si el usuario inició, `OUTBOUND` si fue por campaña |
| `contact_id` | Int64 | Identificador del contacto en Treble. `0` si no tiene contacto asociado |
| `finished_at` | DateTime64 | Fecha y hora de finalización |
## Consultas de ejemplo
### Consumo inbound vs outbound por día
```sql theme={null}
SELECT
toDate(created_at) AS dia,
inbound_outbound,
count() AS total,
countIf(is_valid) AS validos
FROM client_analytics.fact_sessions
WHERE created_at >= now() - INTERVAL 30 DAY
GROUP BY dia, inbound_outbound
ORDER BY dia DESC
```
### Top campañas por volumen
```sql theme={null}
SELECT
poll_name,
inbound_outbound,
count() AS flujos,
countIf(status = 'HumanHandover') AS pasaron_a_agente
FROM client_analytics.fact_sessions
WHERE created_at >= now() - INTERVAL 30 DAY
GROUP BY poll_name, inbound_outbound
ORDER BY flujos DESC
LIMIT 20
```
# Optimización de Consultas
Source: https://help.treble.ai/es/docs/data-warehouse/query-optimization
Cómo escribir consultas eficientes contra el Data Warehouse.
# Optimización de Consultas
El Data Warehouse está construido sobre ClickHouse, una base de datos columnar. Esto significa que las consultas se comportan diferente a una base de datos relacional tradicional. Aquí te explicamos cómo aprovechar la estructura para obtener resultados rápidos.
## Principios Clave
### 1. Siempre filtra por fecha
Todas las tablas de hechos están **particionadas por mes** (`toYYYYMM(created_at)`). Filtrar por fecha permite a ClickHouse saltar particiones enteras sin leerlas.
```sql theme={null}
-- Bueno: ClickHouse lee solo 1 partición
SELECT * FROM fact_conversations
WHERE created_at >= '2026-04-01' AND created_at < '2026-05-01'
-- Malo: ClickHouse lee todas las particiones
SELECT * FROM fact_conversations
WHERE agent_name = 'Juan'
```
### 2. No necesitas filtrar por company\_id
Tu usuario tiene una **política de fila** que filtra automáticamente por tu empresa. No necesitas agregar `WHERE company_id = ...` — se aplica de forma transparente.
### 3. Selecciona solo las columnas que necesitas
ClickHouse es columnar: solo lee las columnas que mencionas en tu `SELECT`. Menos columnas = menos datos leídos = más rápido.
```sql theme={null}
-- Bueno: lee solo 3 columnas
SELECT conversation_id, created_at, status
FROM fact_conversations
WHERE created_at >= now() - INTERVAL 7 DAY
-- Evita: lee todas las columnas
SELECT *
FROM fact_conversations
WHERE created_at >= now() - INTERVAL 7 DAY
```
### 4. Usa LIMIT para explorar
Cuando estés explorando datos, usa `LIMIT` para evitar traer millones de filas:
```sql theme={null}
SELECT * FROM fact_agent_messages
WHERE created_at >= now() - INTERVAL 1 DAY
ORDER BY created_at DESC
LIMIT 100
```
## Estructura Interna de las Tablas
Cada tabla tiene un **orden de clasificación** (sort key) que determina cómo se organizan los datos en disco. Las consultas que filtran por las primeras columnas del sort key son mucho más eficientes.
### Sort Keys por Tabla
| Tabla | Sort Key | Filtra eficientemente por |
| --------------------------- | ---------------------------------------------------- | ------------------------- |
| `fact_conversations` | `(company_id, created_at, conversation_id)` | fecha, conversation\_id |
| `fact_agent_messages` | `(company_id, created_at, message_id)` | fecha, message\_id |
| `fact_redirections` | `(company_id, created_at, redirection_id)` | fecha |
| `fact_agent_status_changes` | `(company_id, agent_id, created_at)` | agent\_id + fecha |
| `fact_agent_daily` | `(company_id, day, agent_id)` | día, agent\_id |
| `fact_sessions` | `(company_id, created_at, session_id)` | fecha, session\_id |
| `fact_deployment_status` | `(company_id, timestamps_eta, deployment_id)` | fecha |
| `fact_deployment_daily` | `(company_id, day, poll_id)` | día, poll\_id |
| `fact_inbound_messages` | `(company_id, created_at, session_id)` | fecha |
| `fact_whatsapp_links` | `(company_id, created_at, event_id)` | fecha |
| `fact_hsm_responses` | `(company_id, response_date, interaction_answer_id)` | fecha |
`company_id` es siempre la primera columna del sort key. Como tu usuario tiene un filtro automático por empresa, todas tus consultas aprovechan esta optimización sin que tengas que hacer nada.
### Índices Secundarios
Algunas tablas tienen índices adicionales que ayudan a filtrar por columnas que no están en el sort key:
| Tabla | Índice | Columna | Tipo | Útil para |
| ------------------------ | ---------------------- | ------------------ | ------------- | -------------------------------------------------- |
| `fact_agent_messages` | `idx_conversation_id` | `conversation_id` | minmax | Buscar mensajes de una conversación específica |
| `fact_agent_messages` | `idx_sender` | `sender` | bloom\_filter | Filtrar por `sender = 'AGENT'` o `sender = 'USER'` |
| `fact_sessions` | `idx_poll_id` | `poll_id` | minmax | Filtrar por campaña |
| `fact_sessions` | `idx_inbound_outbound` | `inbound_outbound` | bloom\_filter | Filtrar por tipo INBOUND/OUTBOUND |
| `fact_deployment_status` | `idx_poll_id` | `poll_id` | minmax | Filtrar por campaña |
| `fact_deployment_status` | `idx_status` | `status` | bloom\_filter | Filtrar por estado de envío |
| `fact_inbound_messages` | `idx_poll_id` | `poll_id` | minmax | Filtrar por campaña |
| `fact_hsm_responses` | `idx_hsm_id` | `hsm_id` | minmax | Filtrar por plantilla HSM |
| `fact_hsm_responses` | `idx_poll_id` | `poll_id` | minmax | Filtrar por campaña |
## Límites del Sistema
Tu usuario tiene los siguientes límites para proteger la estabilidad del sistema:
| Límite | Valor |
| ---------------------------- | ----------- |
| Tiempo máximo de ejecución | 30 segundos |
| Máximo de filas leídas | 50 millones |
| Máximo de bytes leídos | 5 GB |
| Máximo de filas en resultado | 500,000 |
| Máximo de memoria | 2 GB |
Si tu consulta excede alguno de estos límites, será cancelada automáticamente. Para evitarlo:
* Agrega filtros de fecha más estrechos
* Selecciona menos columnas
* Usa `LIMIT`
* Pre-agrega con `GROUP BY` en lugar de traer filas individuales
## Patrones Comunes
### JOIN entre tablas de hechos
Puedes cruzar tablas usando `conversation_id` o `survey_user_id`:
```sql theme={null}
-- Mensajes de una conversación con datos de la conversación
SELECT
fc.conversation_id,
fc.agent_name,
fm.created_at AS mensaje_fecha,
fm.sender,
fm.content
FROM client_analytics.fact_conversations fc
INNER JOIN client_analytics.fact_agent_messages fm
ON fm.conversation_id = fc.conversation_id
WHERE fc.created_at >= now() - INTERVAL 7 DAY
ORDER BY fm.created_at
LIMIT 1000
```
### JOIN con dimensiones
```sql theme={null}
-- Productividad por equipo (team_name viene de la dimensión)
SELECT
at.team_name,
sum(ad.chats_handled) AS chats,
round(avg(ad.avg_first_response_sec), 0) AS respuesta_promedio_seg
FROM client_analytics.fact_agent_daily ad
INNER JOIN client_analytics.dim_agent_tags at ON at.agent_id = ad.agent_id
WHERE ad.day >= today() - 30
GROUP BY at.team_name
ORDER BY chats DESC
```
### Nivel de servicio personalizado
```sql theme={null}
-- Define tu propio umbral de SLA
SELECT
toDate(created_at) AS dia,
count() AS conversaciones,
countIf(first_response_sec <= 60) AS dentro_60s,
countIf(first_response_sec <= 120) AS dentro_120s,
countIf(first_response_sec <= 300) AS dentro_5min,
round(countIf(first_response_sec <= 120) * 100.0 / count(), 1) AS sla_pct
FROM client_analytics.fact_conversations
WHERE created_at >= now() - INTERVAL 30 DAY
AND first_response_sec IS NOT NULL
GROUP BY dia
ORDER BY dia DESC
```
# Data Warehouse (Legacy)
Source: https://help.treble.ai/es/docs/data-warehouse/welcome
Consulta tus datos directamente con SQL. Disponible para empresas con acceso habilitado.
# Data Warehouse (Legacy)
Este Data Warehouse está **deprecado** y fue reemplazado por el nuevo [Analytics Warehouse](/es/docs/data-warehouse-v2/welcome), que ofrece datos casi en tiempo real, historia completa y nuevos datasets como la traza de mensajes y el recorrido por los flujos. Sigue funcionando durante el periodo de migración, pero toda integración nueva debe usar el Analytics Warehouse. Consulta la [guía de migración](/es/docs/data-warehouse-v2/migration-guide) para actualizar tus queries.
Treble pone a disposición un Data Warehouse que te permite consultar directamente tus datos operacionales con SQL. Esto te da la flexibilidad de construir reportes personalizados, conectar herramientas de BI y analizar tus datos sin depender del equipo de Treble.
El acceso al Data Warehouse está disponible únicamente para empresas que soliciten el onboarding. Si estás interesado, contacta a tu Account Manager o escríbenos a soporte para iniciar el proceso.
## ¿Qué puedes consultar?
* Historial de conversaciones atendidas por tus agentes
* Mensajes enviados y recibidos en cada conversación
* Transferencias entre agentes
* Disponibilidad y tiempos de conexión de agentes
* Productividad diaria por agente
* Detalle y métricas de envíos de campañas outbound
* Sesiones inbound y outbound
## Conexión
Una vez habilitado el acceso, recibirás credenciales para conectarte:
| Parámetro | Valor |
| ----------------- | ------------------------------------ |
| **Host** | Proporcionado por Treble |
| **Puerto** | `8443` (HTTPS) / `9440` (Native TLS) |
| **Base de datos** | `client_analytics` |
| **Usuario** | Proporcionado por Treble |
| **Contraseña** | Proporcionada por Treble |
Puedes usar cualquier cliente compatible con ClickHouse: DBeaver, DataGrip, `clickhouse-client`, o conectar directamente desde Google Sheets, Metabase, Looker u otra herramienta de BI.
## Seguridad y Límites
* **Datos seguros:** Tus datos están protegidos por políticas de privacidad. Solo tu compañía puede acceder a la información de tu cuenta.
* **Solo lectura:** Tu usuario no puede modificar, crear ni eliminar datos.
* **Límites de protección:** Las consultas tienen un tiempo máximo de 30 segundos y límites de filas y memoria para garantizar la estabilidad del sistema.
## Frecuencia de Actualización
* Los datos tienen un **retraso máximo de 3 horas** respecto a la operación en tiempo real.
* Las tablas contienen datos de los **últimos 3 meses**.
* Algunas tablas (dimensiones de agentes, equipos, tags) pueden tener una frecuencia de actualización mayor, cercana a los 10 minutos.
## Buenas Prácticas
Para escribir consultas eficientes y aprovechar al máximo la estructura columnar de ClickHouse, revisa la guía de [Optimización de Consultas](/es/docs/data-warehouse/query-optimization).
## Tablas Disponibles
### Tablas de hechos (facts)
Contienen los eventos y transacciones de tu operación.
| Tabla | ¿Qué responde? | Granularidad |
| -------------------------------------------------------------------------------- | ------------------------------------------------------------------- | ---------------------------- |
| [`fact_conversations`](/es/docs/data-warehouse/fact-conversations) | ¿Cuántas conversaciones se atendieron? ¿Por quién? ¿Cuánto duraron? | 1 fila por conversación |
| [`fact_agent_messages`](/es/docs/data-warehouse/fact-agent-messages) | ¿Qué se dijo en cada conversación? ¿Quién envió cada mensaje? | 1 fila por mensaje |
| [`fact_redirections`](/es/docs/data-warehouse/fact-redirections) | ¿Cuántas transferencias hubo? ¿De quién a quién? | 1 fila por transferencia |
| [`fact_agent_status_changes`](/es/docs/data-warehouse/fact-agent-status-changes) | ¿Cuándo se conectaron y desconectaron los agentes? | 1 fila por cambio de estado |
| [`fact_agent_daily`](/es/docs/data-warehouse/fact-agent-daily) | ¿Cuál fue la productividad de cada agente por día? | 1 fila por agente por día |
| [`fact_sessions`](/es/docs/data-warehouse/fact-sessions) | ¿Cuántas sesiones tuvo la campaña? ¿Inbound o outbound? | 1 fila por sesión |
| [`fact_deployment_status`](/es/docs/data-warehouse/fact-deployment-status) | ¿Cuál fue el resultado de cada envío outbound? | 1 fila por envío |
| [`fact_deployment_daily`](/es/docs/data-warehouse/fact-deployment-daily) | ¿Cuántos envíos por campaña por día? ¿Tasa de entrega y respuesta? | 1 fila por campaña por día |
| [`fact_hsm_responses`](/es/docs/data-warehouse/fact-hsm-responses) | ¿Qué respondieron los usuarios a las plantillas HSM? | 1 fila por respuesta |
| `fact_target_events` | ¿Qué objetivos de conversión se cumplieron? *(Próximamente)* | 1 fila por objetivo cumplido |
### Tablas de dimensiones (dims)
Contienen información de referencia que puedes cruzar con las tablas de hechos.
| Tabla | Descripción |
| ------------------------------------------------------ | ---------------------------------------------- |
| [`dim_agents`](/es/docs/data-warehouse/dimensions) | Agentes: nombre, email, estado activo/inactivo |
| [`dim_tags`](/es/docs/data-warehouse/dimensions) | Colas o tags de asignación |
| [`dim_teams`](/es/docs/data-warehouse/dimensions) | Equipos de trabajo |
| [`dim_hsm`](/es/docs/data-warehouse/dimensions) | Plantillas HSM (templates de WhatsApp) |
| [`dim_agent_tags`](/es/docs/data-warehouse/dimensions) | Relación agente ↔ tag ↔ equipo |
## Ejemplo Rápido
```sql theme={null}
-- Conversaciones atendidas en los últimos 7 días
SELECT
created_at,
conversation_id,
agent_name,
status,
finish_type
FROM client_analytics.fact_conversations
WHERE created_at >= now() - INTERVAL 7 DAY
ORDER BY created_at DESC
LIMIT 100
```
# Ejemplos de uso de la integración con Active Campaign
Source: https://help.treble.ai/es/docs/integrations/activecampaign/examples
Esta guía te da algunas recetas de escenarios y casos de uso de la integración de Treble con Active Campaign.
Este artículo muestra un escenario real para usar Active Campaign con Treble desde un agente de IA: validar si el cliente ya existe en el CRM como Contacto, crearlo si no existe, actualizar sus datos, crear un negocio (Deal / Oportunidad) y transferir la conversación a un agente humano.
## Escenario práctico: calificación y handoff a ventas
Imagina que tus clientes te escriben por WhatsApp para pedir información comercial. Tu objetivo es automatizar este flujo:
1. Revisar si el cliente ya está registrado en Active Campaign como **Contacto**.
2. Si no existe, crearlo en Active Campaign y registrar los datos básicos.
3. Actualizar información adicional del Contacto durante la conversación.
4. Crear un **Negocio (Deal / Oportunidad)** con información de cotización.
5. Transferir la conversación a un agente humano en Treble.
## Herramientas que intervienen
En este escenario puedes combinar herramientas como:
* Búsqueda de Contacto por teléfono.
* `create_crm_contact` para registrar al cliente.
* `update_crm_contact` para completar campos faltantes.
* `create_crm_deal` para crear la oportunidad comercial.
* `transferToAgent` para handoff al equipo humano.
## Prompt recomendado (ejemplo completo)
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Active Campaign antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Contacto por teléfono usando:
\[PLACEHOLDER\_TOOL\_CALL\_SEARCH\_CONTACT\_BY\_PHONE]
2. Si no existe Contacto, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Contacto usando:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_CONTACT]
3. Si el Contacto ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
\[PLACEHOLDER\_TOOL\_CALL\_UPDATE\_CONTACT]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
\[PLACEHOLDER\_TOOL\_CALL\_TRANSFER\_TO\_AGENT]
### Reglas de comportamiento
* Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
* No inventes datos: solo guarda en CRM lo confirmado por el cliente.
* Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
* Si detectas que el cliente ya existe, continúa el flujo sobre ese mismo Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```text theme={null}
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Active Campaign antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Contacto por teléfono usando:
[PLACEHOLDER_TOOL_CALL_SEARCH_CONTACT_BY_PHONE]
2. Si no existe Contacto, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Contacto usando:
[PLACEHOLDER_TOOL_CALL_CREATE_CONTACT]
3. Si el Contacto ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
[PLACEHOLDER_TOOL_CALL_UPDATE_CONTACT]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
[PLACEHOLDER_TOOL_CALL_CREATE_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
[PLACEHOLDER_TOOL_CALL_TRANSFER_TO_AGENT]
### Reglas de comportamiento
- Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
- No inventes datos: solo guarda en CRM lo confirmado por el cliente.
- Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
- Si detectas que el cliente ya existe, continúa el flujo sobre ese mismo Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```
## Recomendaciones para adaptar este ejemplo
* Ajusta nombres de campos (`slug`) según tus propiedades reales en Active Campaign.
* Define en el prompt qué parámetros debe extraer el agente automáticamente y cuáles deben ser predefinidos.
* Adapta las herramientas y placeholders a los nombres reales disponibles para Contacto y Deal.
* Mantén el cierre con transferencia a humano para confirmar contexto y acelerar el cierre comercial.
Este patrón aplica para múltiples casos: captación de contactos, calificación comercial, actualización de CRM y handoff a equipos humanos.
# Funcionalidades de la integración con Active Campaign
Source: https://help.treble.ai/es/docs/integrations/activecampaign/features
Esta guía te muestra cómo usar las funcionalidades de la integración de Treble con Active Campaign.
La integración de Active Campaign con Treble te permite interactuar con múltiples entidades desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Contacto, Negocio (Deal / Oportunidad) y Pipeline.
Con estas entidades, las herramientas de la integración te permiten ejecutar distintas acciones según el tipo de entidad. En Contacto y Negocio (Deal / Oportunidad) puedes crear, actualizar, eliminar, listar y consultar registros individuales. En Pipeline puedes consultar uno, listar varios o eliminar.
# Acciones disponibles por entidad
## Contacto
| Acción | ¿Qué puedes hacer? |
| -------- | --------------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo contacto en Active Campaign, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un contacto existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un contacto existente en Active Campaign. |
| *List* | Listar múltiples contactos según los filtros disponibles. |
| *Get* | Consultar un contacto específico por su identificador. |
## Negocio (Deal / Oportunidad)
| Acción | ¿Qué puedes hacer? |
| -------- | -------------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo negocio en Active Campaign, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un negocio existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un negocio existente en Active Campaign. |
| *List* | Listar múltiples negocios según los filtros disponibles. |
| *Get* | Consultar un negocio específico por su identificador. |
## Pipeline
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------ |
| *Remove* | Eliminar un pipeline existente en Active Campaign. |
| *List* | Listar múltiples pipelines disponibles. |
| *Get* | Consultar un pipeline específico por su identificador. |
# ¿Cómo usar las herramientas de Treble para Active Campaign?
La integración de Active Campaign con Treble hace uso de el asistente de IA "Automatizar tareas complejas" para ejecutar las acciones de las herramientas de Treble para Active Campaign. Para ello, es indispensable que sepas cómo usar el asistente de IA "Automatizar tareas complejas" en Treble y cómo configurar las herramientas de Treble para Active Campaign.
Si necesitas más información sobre cómo usar el asistente de IA "Automatizar tareas complejas" en Treble, puedes consultar la documentación de "Automatizar tareas complejas" en Treble en el siguiente enlace:
Aprende a usar el asistente de IA "Automatizar tareas complejas" en Treble.
# Configuración de las herramientas de Treble para Active Campaign
Para configurar las herramientas de Treble para Active Campaign, debes seguir los siguientes pasos:
1. Ingresa a la sección de "Agentes de IA" en Treble.
2. Crea un nuevo agente de IA.
3. Selecciona la opción de "Automatizar tareas complejas".
4. En la sección de "Herramientas", selecciona la herramienta de "Aplicaciones Conectadas".
5. En la sección de "Aplicaciones Conectadas", selecciona la aplicación de "Active Campaign".
6. En la sección de "Herramientas", selecciona la herramienta de "Active Campaign" que deseas configurar.
Este proceso es el mismo para todas las herramientas listadas de Treble para Active Campaign. Sin embargo, cada herramienta tiene sus propias configuraciones. Explicaremos las configuraciones de cada herramienta a continuación.
## Herramienta Buscar Contacto por Teléfono
Dentro de las herramientas listadas de Treble para Active Campaign, existe la herramienta "Buscar Contacto por Teléfono". Esta herramienta te permite buscar Contactos por teléfono. La herramienta automáticamente busca el Contacto en Active Campaign según el teléfono de WhatsApp del cliente que está interactuando con tu asistente de IA por medio de una línea de WhatsApp conectada a Treble. No es necesario que tu asistente de IA tenga que preguntar por el teléfono del cliente, la herramienta lo hará automáticamente.
Haz clic en la opción de buscar Contacto por teléfono. Una vez hayas dado clic, esta herramienta no tiene más configuraciones. En los siguientes dos pasos haz clic en "Siguiente Paso" y finalmente haz clic en "Guardar Configuración". Verás la herramienta añadida dentro de las instrucciones de tu asistente de IA.
### Formato del teléfono en Active Campaign y propiedades
Treble utiliza el formato de teléfono internacional para buscar Contactos en Active Campaign. Por ejemplo, si el teléfono del cliente es del país Estados Unidos y el teléfono es `(917) 555-0111`, Treble lo buscará en Active Campaign como `+19175550111`. Treble hará la búsqueda dentro de la propiedad `Phone`.
Ten en cuenta que, en últimas, el agente de IA es quien decide en qué formato realizar la búsqueda. Por defecto, el agente intentará buscar en formato internacional. Sin embargo, si en tu Active Campaign los teléfonos no están guardados en formato internacional, puedes indicarle al agente dentro de sus instrucciones (prompt) qué formato debe usar para hacer la búsqueda.
Ejemplos de instrucciones para el agente de IA:
* Colombia: "Cuando uses la herramienta de buscar Contacto por teléfono, busca primero en formato local de Colombia (por ejemplo, `3001234567`) y, si no encuentras resultados, intenta en formato internacional (`+573001234567`)."
* Argentina: "Cuando busques por teléfono en Active Campaign, prioriza formato local de Argentina (por ejemplo, `1151234567` o `3515123456`). Si no hay coincidencias, intenta formato internacional (`+541151234567` o `+543515123456`)."
* Brasil: "Para buscar Contactos por teléfono, usa primero formato local de Brasil (por ejemplo, `11987654321`). Si no hay resultados, prueba también formato internacional (`+5511987654321`)."
## Herramientas con Opciones de Configuración
Para las demás herramientas, como Crear Contacto, Actualizar Contacto, Crear Negocio, Buscar (Get) un Pipeline, etc., estas herramientas tienen opciones de configuración. Estas opciones de configuración te permiten interactuar con propiedades de esas entidades. Estas propiedades pueden ser estándar o personalizadas. Miremos algunos ejemplos de configuraciones de herramientas.
### Ejemplo Crear Contacto
La herramienta "Crear Contacto" te permite crear un nuevo contacto en Active Campaign. Para configurar esta herramienta, debes seguir los siguientes pasos:
1. Activa la vista de herramientas de Active Campaign dentro de la sección de "Herramientas" de tu asistente de IA.
2. Haz clic en la herramienta de "Create CRM Contact".
3. En esta vista selecciona las propiedades que deseas configurar para el contacto. Puedes seleccionar propiedades estándar o personalizadas. En este ejemplo, vamos a seleccionar las propiedades "Name", "Emails", "Telephone" y "Metadata".
4. Haz clic en "Siguiente Paso". En la vista "Parámetros manejados por Agente IA" debes seleccionar qué propiedades quieres que el agente de IA complete dinámicamente durante la conversación.
Cuando una propiedad está marcada como "manejada por Agente IA", el agente intentará extraer ese valor del contexto del chat (por ejemplo, nombre, email o teléfono). Si no encuentra el dato con suficiente claridad, hará una pregunta al cliente para completarlo antes de ejecutar la herramienta.
Para obtener mejores resultados, define instrucciones explícitas en el prompt del agente sobre qué campos debe recopilar y cómo debe hacerlo. Ejemplo recomendado: "Cuando uses la herramienta Crear Contacto, intenta extraer `Name`, `Emails` y `Telephone` del contexto de la conversación. Si falta alguno, solicítalo al cliente de forma breve y luego crea el Contacto."
En esta vista marca solo los campos variables. Los campos que quieras fijar con un valor predefinido (por ejemplo, `Metadata = Nuevo`) puedes dejarlos sin seleccionar aquí y configurarlos en la siguiente sección.
En este caso vamos a seleccionar las propiedades "Name", "Emails" y "Telephone". (Dejamos sin seleccionar la propiedad "Metadata" para configurarla en la siguiente sección.)
5. En la siguiente vista, vamos a configurar los campos donde el Contacto se debería crear con algunas propiedades predefinidas. Por ejemplo, si deseas que el contacto se cree con el estado "Nuevo", vamos a escribir en el campo "Metadata" el valor "Nuevo". Esto lo puedes configurar con múltiples propiedades, es decir, puedes configurar varias propiedades con un valor predefinido; lo importante es no seleccionarlas dentro de la vista "Parámetros manejados por Agente IA".
¡Felicitaciones! Ya has configurado la herramienta Crear Contacto.
# Conclusiones Finales
Este ejemplo de configuración de la herramienta **Crear Contacto** y de sus parámetros aplica de forma idéntica para las demás herramientas de Active Campaign y sus opciones de configuración. La lógica es la misma: definir qué propiedades se completan con datos extraídos por el agente de IA, cuáles se dejan como valores predefinidos y cómo se ejecuta la acción según la entidad. Esto aplica en casos como **List Pipeline**, **Get Contact** y **Update Deal**, entre otros.
# Instalación de la integración con Active Campaign
Source: https://help.treble.ai/es/docs/integrations/activecampaign/installation
Esta guía te muestra cómo instalar la integración de Treble con Active Campaign.
Para instalar la integración de tu producto con Active Campaign, es crucial que el usuario tenga permisos de administrador en la cuenta de Active Campaign.
# Pasos para instalar la integración de Active Campaign en Treble
1. Inicia sesión en
2. Dirígete a Configuración
3. Dirígete a Integraciones
4. Haz clic en la pestaña de "Aplicaciones Conectadas"
En este punto vamos a seguir las instrucciones. Has clic en el botón de "Conectar Aplicación" y se te abrirá un modal con las opciones de conexión. Has clic en "Active Campaign".
Al hacer clic en "Active Campaign", se abrirá la pantalla **Iniciar sesión y autorizar**, donde Treble.ai solicita acceso a tu cuenta de Active Campaign. Completa los siguientes campos:
* **API Key**: ingresa tu clave API de Active Campaign. Puedes encontrarla en tu cuenta, en la sección de configuración para desarrolladores.
* **Domain**: ingresa el nombre de dominio de tu cuenta (solo el nombre, sin URL completa). Usualmente corresponde al subdominio de tu endpoint de API.
Cuando la información esté correcta, haz clic en **Autorizar** para completar la conexión. Si deseas cancelar el proceso, haz clic en **Anular**.
Ya conectaste la aplicación de Active Campaign en Treble.
Ahora puedes usar las herramientas de Active Campaign para la IA en Treble. Para ello, ve a la sección de "Agentes de IA" y crea un nuevo agente de IA. Debes seleccionar la opción de "Automatizar tareas complejas". Después de crear el agente, ve a la sección de "Herramientas" y selecciona en la lista de herramientas la opción de "Aplicaciones Conectadas". En esta sección, selecciona la aplicación de "Active Campaign" y verás las herramientas disponibles para usar en la IA.
¡Felicitaciones! Ya lograste instalar la integración de Active Campaign en Treble.
En la siguiente sección, te explicamos cómo usar las herramientas de Active Campaign para la IA en Treble.
# Integración con Active Campaign
Source: https://help.treble.ai/es/docs/integrations/activecampaign/welcome
Esta guía te muestra cómo integrar Treble con Active Campaign.
Treble te ayuda a aprovechar todo el potencial de WhatsApp para vender más de forma integrada con Active Campaign y con IA. La integración de Active Campaign te permite conectar Active Campaign con Treble para actualizar y consultar información de tus entidades desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Contacto, Negocio (Deal / Oportunidad) y Pipeline.
## Funcionalidades
1. Actualizar información de tus entidades en Active Campaign
* Puedes actualizar información de Contacto, Negocio (Deal / Oportunidad) y Pipeline, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
2. Obtener información de tus entidades para usar en tus conversaciones en Treble
* Puedes obtener información de Contacto, Negocio (Deal / Oportunidad) y Pipeline para usar en tus conversaciones en Treble, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
3. Crear entidades en Active Campaign
* Puedes crear Contactos y Negocios (Deal / Oportunidad) en Active Campaign con propiedades estándar y personalizadas.
4. Eliminar entidades en Active Campaign
* Puedes eliminar Contactos y Negocios (Deal / Oportunidad) en Active Campaign.
## Ejemplos de uso
1. Tus clientes te contactan por WhatsApp, nuestro asistente de IA responde preguntas frecuentes de tus clientes, revisa si el Contacto existe en Active Campaign, si no, lo crea y transfiere la conversación a un agente de tu equipo en Treble.
2. Tu cliente quiere actualizar información de su cuenta, el agente de IA puede hacer las preguntas necesarias para actualizar datos del Contacto en Active Campaign.
3. Tu cliente te contacta porque necesita ayuda con su potencial compra de un producto, el agente de IA puede revisar el Negocio (Deal / Oportunidad) en Active Campaign y actualizar su estado e información.
4. Tu equipo comercial necesita visibilidad del avance de ventas, el agente de IA puede consultar el Pipeline en Active Campaign para identificar en qué etapa está cada Negocio y guiar la siguiente acción en la conversación.
# Ejemplos de uso de la integración con Pipedrive
Source: https://help.treble.ai/es/docs/integrations/pipedrive/examples
Esta guía te algunas recetas de escenarios y casos de uso de la integración de Treble con Pipedrive.
Este artículo muestra un escenario real para usar Pipedrive con Treble desde un agente de IA: validar si el cliente ya existe en el CRM, crearlo si no existe, actualizar sus datos, crear un negocio (Deal / Oportunidad) y transferir la conversación a un agente humano.
## Escenario práctico: calificación y handoff a ventas
Imagina que tus clientes te escriben por WhatsApp para pedir información comercial. Tu objetivo es automatizar este flujo:
1. Revisar si el cliente ya está registrado en Pipedrive como **Lead** o **Contacto**.
2. Si no existe, crearlo en Pipedrive y registrar los datos básicos.
3. Actualizar información adicional del Lead/Contacto durante la conversación.
4. Crear un **Negocio (Deal / Oportunidad)** con información de cotización.
5. Transferir la conversación a un agente humano en Treble.
## Herramientas que intervienen
En este escenario puedes combinar herramientas como:
* Búsqueda de Lead/Contacto por teléfono.
* `create_crm_lead` o `create_crm_contact` para registrar al cliente.
* `update_crm_lead` o `update_crm_contact` para completar campos faltantes.
* `create_crm_deal` para crear la oportunidad comercial.
* `transferToAgent` para handoff al equipo humano.
## Prompt recomendado (ejemplo completo)
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Pipedrive antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Lead por teléfono usando:
\[PLACEHOLDER\_TOOL\_CALL\_SEARCH\_LEAD\_BY\_PHONE]
2. Si no existe Lead, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Lead usando:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_LEAD]
3. Si el Lead ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
\[PLACEHOLDER\_TOOL\_CALL\_UPDATE\_LEAD]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
\[PLACEHOLDER\_TOOL\_CALL\_TRANSFER\_TO\_AGENT]
### Reglas de comportamiento
* Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
* No inventes datos: solo guarda en CRM lo confirmado por el cliente.
* Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
* Si detectas que el cliente ya existe como Contacto y no como Lead, continúa el flujo usando Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```text theme={null}
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Pipedrive antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Lead por teléfono usando:
[PLACEHOLDER_TOOL_CALL_SEARCH_LEAD_BY_PHONE]
2. Si no existe Lead, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Lead usando:
[PLACEHOLDER_TOOL_CALL_CREATE_LEAD]
3. Si el Lead ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
[PLACEHOLDER_TOOL_CALL_UPDATE_LEAD]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
[PLACEHOLDER_TOOL_CALL_CREATE_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
[PLACEHOLDER_TOOL_CALL_TRANSFER_TO_AGENT]
### Reglas de comportamiento
- Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
- No inventes datos: solo guarda en CRM lo confirmado por el cliente.
- Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
- Si detectas que el cliente ya existe como Contacto y no como Lead, continúa el flujo usando Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```
## Recomendaciones para adaptar este ejemplo
* Ajusta nombres de campos (`slug`) según tus propiedades reales en Pipedrive.
* Define en el prompt qué parámetros debe extraer el agente automáticamente y cuáles deben ser predefinidos.
* Si tu operación usa Contacto en vez de Lead, reemplaza herramientas de Lead por Contacto en el mismo flujo.
* Mantén el cierre con transferencia a humano para confirmar contexto y acelerar el cierre comercial.
Este patrón aplica para múltiples casos: captación de leads, calificación comercial, actualización de CRM y handoff a equipos humanos.
# Funcionalidades de la integración con Pipedrive
Source: https://help.treble.ai/es/docs/integrations/pipedrive/features
Esta guía te muestra cómo usar las funcionalidades de la integración de Treble con Pipedrive.
La integración de Pipedrive con Treble te permite interactuar con múltiples entidades en Pipedrive desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline.
Con estas entidades, las herramientas de la integración te permiten ejecutar distintas acciones según el tipo de entidad. En Lead, Contacto y Negocio (Deal / Oportunidad) puedes crear, actualizar, eliminar, listar y consultar registros individuales. En Pipeline puedes consultar uno, listar varios o eliminar.
# Acciones disponibles por entidad
## Lead
| Acción | ¿Qué puedes hacer? |
| -------- | ----------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo lead en Pipedrive, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un lead existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un lead existente en Pipedrive. |
| *List* | Listar múltiples leads según los filtros disponibles. |
| *Get* | Consultar un lead específico por su identificador. |
## Contacto
| Acción | ¿Qué puedes hacer? |
| -------- | --------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo contacto en Pipedrive, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un contacto existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un contacto existente en Pipedrive. |
| *List* | Listar múltiples contactos según los filtros disponibles. |
| *Get* | Consultar un contacto específico por su identificador. |
## Negocio (Deal / Oportunidad)
| Acción | ¿Qué puedes hacer? |
| -------- | -------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo negocio en Pipedrive, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un negocio existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un negocio existente en Pipedrive. |
| *List* | Listar múltiples negocios según los filtros disponibles. |
| *Get* | Consultar un negocio específico por su identificador. |
## Pipeline
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------ |
| *Remove* | Eliminar un pipeline existente en Pipedrive. |
| *List* | Listar múltiples pipelines disponibles. |
| *Get* | Consultar un pipeline específico por su identificador. |
# ¿Cómo usar las herramientas de Treble para Pipedrive?
La integración de Pipedrive con Treble hace uso de el asistente de IA "Automatizar tareas complejas" para ejecutar las acciones de las herramientas de Treble para Pipedrive. Para ello, es indispensable que sepas cómo usar el asistente de IA "Automatizar tareas complejas" en Treble y cómo configurar las herramientas de Treble para Pipedrive.
Si necesitas más información sobre cómo usar el asistente de IA "Automatizar tareas complejas" en Treble, puedes consultar la documentación de "Automatizar tareas complejas" en Treble en el siguiente enlace:
Aprende a usar el asistente de IA "Automatizar tareas complejas" en Treble.
# Configuración de las herramientas de Treble para Pipedrive
Para configurar las herramientas de Treble para Pipedrive, debes seguir los siguientes pasos:
1. Ingresa a la sección de "Agentes de IA" en Treble.
2. Crea un nuevo agente de IA.
3. Selecciona la opción de "Automatizar tareas complejas".
4. En la sección de "Herramientas", selecciona la herramienta de "Aplicaciones Conectadas".
5. En la sección de "Aplicaciones Conectadas", selecciona la aplicación de "Pipedrive".
6. En la sección de "Herramientas", selecciona la herramienta de "Pipedrive" que deseas configurar.
Este proceso es el mismo para todas las herramientas listadas de Treble para Pipedrive. Sin embargo, cada herramienta tiene sus propias configuraciones. Explicaremos las configuraciones de cada herramienta a continuación.
## Herramienta Buscar Lead o Contacto por Teléfono
Dentro de las herramientas listadas de Treble para Pipedrive, existe la herramienta "Buscar Lead o Contacto por Teléfono". Esta herramienta te permite buscar Leads o Contactos por teléfono. La herramienta automáticamente busca el Lead o Contacto en Pipedrive según el teléfono de WhatsApp del cliente que esta interactuando con tu asistente de IA por medio de una linea de WhatsApp conectada a Treble. No es necesario que tu asistente de IA tenga que preguntar por el teléfono del cliente, la herramienta lo hará automáticamente.
Has click en la opción que desees configurar entre buscar Lead o Contacto por teléfono. Una vez hayas dado click, esta herramiento no tiene más configuraciones, en los siguientes dos pasos has click en "Siguiente Paso" y finalmente has click en "Guardar Configuración". Verás la herramienta añadida dentro de las instrucciones de tu asistente de IA.
### Formato del teléfono en Pipedrive y propiedades
Treble utiliza el formato de teléfono internacional para buscar Leads o Contactos en Pipedrive. Por ejemplo, si el teléfono del cliente es del país Estados Unidos y el teléfono es `(917) 555-0111`, Treble lo buscará en Pipedrive como `+19175550111`. Treble hará la búsqueda dentro de la propiedad `Phone` en Pipedrive.
Ten en cuenta que, en ultimas, el agente de IA es quien decide en qué formato realizar la busqueda. Por defecto, el agente intentará buscar en formato internacional. Sin embargo, si en tu Pipedrive los telefonos no están guardados en formato internacional, puedes indicarle al agente dentro de sus instrucciones (prompt) qué formato debe usar para hacer la busqueda.
Ejemplos de instrucciones para el agente de IA:
* Colombia: "Cuando uses la herramienta de buscar Lead o Contacto por telefono, busca primero en formato local de Colombia (por ejemplo, `3001234567`) y, si no encuentras resultados, intenta en formato internacional (`+573001234567`)."
* Argentina: "Cuando busques por telefono en Pipedrive, prioriza formato local de Argentina (por ejemplo, `1151234567` o `3515123456`). Si no hay coincidencias, intenta formato internacional (`+541151234567` o `+543515123456`)."
* Brasil: "Para buscar Leads o Contactos por telefono, usa primero formato local de Brasil (por ejemplo, `11987654321`). Si no hay resultados, prueba tambien formato internacional (`+5511987654321`)."
## Herramientas con Opciones de Configuración
Para las demás herramientas, como Crear Lead, Actualizar Contacto, Crear Negocio, Buscar (Get) un Pipeline, etc., estas herramientas tienen opciones de configuración. Estas opciones de configuración te permiten interactuar con propiedades de esas entidades. Estas propiedades pueden ser estándar o personalizadas. Miremos algunos ejemplos de configuraciones de herramientas.
### Ejemplo Crear Lead
La herramienta "Crear Lead" te permite crear un nuevo lead en Pipedrive. Para configurar esta herramienta, debes seguir los siguientes pasos:
1. Activa la vista de herramientas de Pipedrive dentro de la sección de "Herramientas" de tu asistente de IA.
2. Has click en la herramienta de "Create CRM Lead".
3. En esta vista selecciona las propiedades que deseas configurar para el lead. Puedes seleccionar propiedades estándar o personalizadas. En este ejemplo, vamos a seleccionar las propiedades "Name", "Emails", "Telephone" y "Status".
4. Haz click en "Siguiente Paso". En la vista "Parámetros manejados por Agente IA" debes seleccionar qué propiedades quieres que el agente de IA complete dinámicamente durante la conversación.
Cuando una propiedad está marcada como "manejada por Agente IA", el agente intentará extraer ese valor del contexto del chat (por ejemplo, nombre, email o teléfono). Si no encuentra el dato con suficiente claridad, hará una pregunta al cliente para completarlo antes de ejecutar la herramienta.
Para obtener mejores resultados, define instrucciones explícitas en el prompt del agente sobre qué campos debe recopilar y cómo debe hacerlo. Ejemplo recomendado: "Cuando uses la herramienta Crear Lead, intenta extraer `Name`, `Emails` y `Telephone` del contexto de la conversación. Si falta alguno, solicítalo al cliente de forma breve y luego crea el Lead."
En esta vista marca solo los campos variables. Los campos que quieras fijar con un valor predefinido (por ejemplo, `Status = Lead`) puedes dejarlos sin seleccionar aquí y configurarlos en la siguiente sección.
En este caso vamos a seleccionar las propiedades "Name", "Emails" y "Telephone". (Dejamos sin seleccionar la propiedad "Status" para configurarla en la siguiente sección.)
5. En la siguiente vista, vamos a configurar los campos donde el Lead se debería crear con algunas propiedades predefinidas. Por ejemplo, si deseas que el lead se cree con el estado "Lead", vamos a escribir en el campo "Status" el valor "Lead". Esto lo puedes configurar con múltiples propiedades, es decir, puedes configurar varias propiedades con un valor predefinido, lo importante es no seleccionarlas dentro de la vista "Parámetros manejados por Agente IA".
¡Felicitaciones! Ya has configurado la herramienta Crear Lead.
# Conclusiones Finales
Este ejemplo de configuración de la herramienta **Crear Lead** y de sus parámetros aplica de forma idéntica para las demás herramientas de Pipedrive y sus opciones de configuración. La lógica es la misma: definir qué propiedades se completan con datos extraídos por el agente de IA, cuáles se dejan como valores predefinidos y cómo se ejecuta la acción según la entidad. Esto aplica en casos como **List Pipeline**, **Get Contact**, **Update Deal**, entre otros.
# Instalación de la integración con Pipedrive
Source: https://help.treble.ai/es/docs/integrations/pipedrive/installation
Esta guía te muestra cómo instalar la integración de Treble con Pipedrive.
Para instalar la integración de tu producto con Pipedrive, es crucial que el usuario tenga permisos de administrador en la cuenta de Pipedrive.
# Pasos para instalar la integración de Pipedrive en Treble
1. Inicia sesión en
2. Dirígete a Configuración
3. Dirígete a Integraciones
4. Haz clic en la pestaña de "Aplicaciones Conectadas"
En este punto vamos a seguir las instrucciones. Has click en el botón de "Conectar Aplicación" y se te abrirá un modal con las opciones de conexión. Has click en "Pipedrive".
Al hacer clic en "Pipedrive", se abrirá la pantalla **Iniciar sesión y autorizar**, donde Treble.ai solicita acceso a tu cuenta de Pipedrive. Completa los siguientes campos:
* **API Token**: introduce tu token de API de Pipedrive. Si no sabes dónde encontrarlo, usa el enlace **Cómo encontrar tu token API** que aparece en la misma pantalla.
* **Domain**: escribe el subdominio de tu cuenta. Es la primera parte de la URL de Pipedrive; por ejemplo, si tu URL es `https://empresa.pipedrive.com`, el dominio es `empresa`.
Cuando los datos estén correctos, haz clic en **Autorizar** para finalizar la conexión. Si prefieres cancelar, usa **Anular**.
Ya conectaste la aplicación de Pipedrive en Treble.
Ahora puedes usar las herramientas de Pipedrive para la IA en Treble. Para ello, ve a la sección de "Agentes de IA" y crea un nuevo agente de IA. Debes seleccionar la opción de "Automatizar tareas complejas". Después de crear el agente, ve a la sección de "Herramientas" y selecciona en la lista de herramientas la opción de "Aplicaciones Conectadas". En esta sección, selecciona la aplicación de "Pipedrive" y verás las herramientas disponibles para usar en la IA.
¡Felicitaciones! Ya lograste instalar la integración de Pipedrive en Treble.
En la siguiente sección, te explicamos cómo usar las herramientas de Pipedrive para la IA en Treble.
# Integración con Pipedrive
Source: https://help.treble.ai/es/docs/integrations/pipedrive/welcome
Esta guía te muestra cómo integrar Treble con Pipedrive.
Treble te ayuda a aprovechar todo el potencial de WhatsApp para vender más de forma integrada con Pipedrive y con IA. La integración de Pipedrive te permite conectar Pipedrive con Treble para actualizar y consultar información de tus entidades en Pipedrive desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline.
## Funcionalidades
1. Actualizar información de tus entidades en Pipedrive
* Puedes actualizar información de Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline en Pipedrive, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
2. Obtener información de tus entidades para usar en tus conversaciones en Treble
* Puedes obtener información de Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline para usar en tus conversaciones en Treble, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
3. Crear entidades en Pipedrive
* Puedes crear Leads, Contactos y Negocios (Deal / Oportunidad) en Pipedrive con propiedades estándar y personalizadas.
4. Eliminar entidades en Pipedrive
* Puedes eliminar Leads, Contactos y Negocios (Deal / Oportunidad) en Pipedrive.
## Ejemplos de uso
1. Tus clientes te contactan por WhatsApp, nuestro asistente de IA responde preguntas frecuentes de tus clientes, revisa si el Lead existe en Pipedrive, si no, lo crea y transfiere la conversación a un agente de tu equipo en Treble.
2. Tu cliente quiere actualizar información de su cuenta, el agente de IA puede hacer las preguntas necesarias para actualizar datos del Lead o Contacto en Pipedrive.
3. Tu cliente te contacta porque necesita ayuda con su potencial compra de un producto, el agente de IA puede revisar el Negocio (Deal / Oportunidad) en Pipedrive y actualizar su estado e información.
4. Tu equipo comercial necesita visibilidad del avance de ventas, el agente de IA puede consultar el Pipeline en Pipedrive para identificar en qué etapa está cada Negocio y guiar la siguiente acción en la conversación.
# Ejemplos de uso de la integración con Salesforce AI
Source: https://help.treble.ai/es/docs/integrations/salesforce/salesforce-ai/examples
Esta guía te da algunas recetas de escenarios y casos de uso de la integración de Treble con Salesforce.
Este artículo muestra un escenario real para usar Salesforce CRM con Treble desde un agente de IA: validar si el cliente ya existe en el CRM, crearlo si no existe, actualizar sus datos, crear un negocio (Deal / Oportunidad) y transferir la conversación a un agente humano.
## Escenario práctico: calificación y handoff a ventas
Imagina que tus clientes te escriben por WhatsApp para pedir información comercial. Tu objetivo es automatizar este flujo:
1. Revisar si el cliente ya está registrado en Salesforce CRM como **Lead** o **Contacto**.
2. Si no existe, crearlo en Salesforce CRM y registrar los datos básicos.
3. Actualizar información adicional del Lead/Contacto durante la conversación.
4. Crear un **Negocio (Deal / Oportunidad)** con información de cotización.
5. Transferir la conversación a un agente humano en Treble.
## Herramientas que intervienen
En este escenario puedes combinar herramientas como:
* Búsqueda de Lead/Contacto por teléfono.
* `create_crm_lead` o `create_crm_contact` para registrar al cliente.
* `update_crm_lead` o `update_crm_contact` para completar campos faltantes.
* `create_crm_deal` para crear la oportunidad comercial.
* `transferToAgent` para handoff al equipo humano.
## Prompt recomendado (ejemplo completo)
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Salesforce CRM antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Lead por teléfono usando:
\[PLACEHOLDER\_TOOL\_CALL\_SEARCH\_LEAD\_BY\_PHONE]
2. Si no existe Lead, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Lead usando:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_LEAD]
3. Si el Lead ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
\[PLACEHOLDER\_TOOL\_CALL\_UPDATE\_LEAD]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
\[PLACEHOLDER\_TOOL\_CALL\_TRANSFER\_TO\_AGENT]
### Reglas de comportamiento
* Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
* No inventes datos: solo guarda en CRM lo confirmado por el cliente.
* Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
* Si detectas que el cliente ya existe como Contacto y no como Lead, continúa el flujo usando Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```text theme={null}
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Salesforce CRM antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Lead por teléfono usando:
[PLACEHOLDER_TOOL_CALL_SEARCH_LEAD_BY_PHONE]
2. Si no existe Lead, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Lead usando:
[PLACEHOLDER_TOOL_CALL_CREATE_LEAD]
3. Si el Lead ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
[PLACEHOLDER_TOOL_CALL_UPDATE_LEAD]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
[PLACEHOLDER_TOOL_CALL_CREATE_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
[PLACEHOLDER_TOOL_CALL_TRANSFER_TO_AGENT]
### Reglas de comportamiento
- Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
- No inventes datos: solo guarda en CRM lo confirmado por el cliente.
- Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
- Si detectas que el cliente ya existe como Contacto y no como Lead, continúa el flujo usando Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```
## Recomendaciones para adaptar este ejemplo
* Ajusta nombres de campos (`slug`) según tus propiedades reales en Salesforce CRM.
* Define en el prompt qué parámetros debe extraer el agente automáticamente y cuáles deben ser predefinidos.
* Si tu operación usa Contacto en vez de Lead, reemplaza herramientas de Lead por Contacto en el mismo flujo.
* Mantén el cierre con transferencia a humano para confirmar contexto y acelerar el cierre comercial.
Este patrón aplica para múltiples casos: captación de leads, calificación comercial, actualización de CRM y handoff a equipos humanos.
# Funcionalidades de la integración con Salesforce AI
Source: https://help.treble.ai/es/docs/integrations/salesforce/salesforce-ai/features
Esta guía te muestra cómo usar las funcionalidades de la integración de Treble con Salesforce.
La integración de Salesforce con Treble te permite interactuar con múltiples entidades en Salesforce CRM desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Lead, Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline.
Con estas entidades, las herramientas de la integración te permiten ejecutar distintas acciones según el tipo de entidad. En Lead, Contacto, Empresa (Company) y Negocio (Deal / Oportunidad) puedes crear, actualizar, eliminar, listar y consultar registros individuales. En Pipeline puedes consultar uno, listar varios o eliminar.
# Acciones disponibles por entidad
## Lead
| Acción | ¿Qué puedes hacer? |
| -------- | ---------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo lead en Salesforce CRM, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un lead existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un lead existente en Salesforce CRM. |
| *List* | Listar múltiples leads según los filtros disponibles. |
| *Get* | Consultar un lead específico por su identificador. |
## Contacto
| Acción | ¿Qué puedes hacer? |
| -------- | -------------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo contacto en Salesforce CRM, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un contacto existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un contacto existente en Salesforce CRM. |
| *List* | Listar múltiples contactos según los filtros disponibles. |
| *Get* | Consultar un contacto específico por su identificador. |
## Empresa (Company)
| Acción | ¿Qué puedes hacer? |
| -------- | -------------------------------------------------------------------------------------------- |
| *Create* | Crear una nueva empresa en Salesforce CRM, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar una empresa existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar una empresa existente en Salesforce CRM. |
| *List* | Listar múltiples empresas según los filtros disponibles. |
| *Get* | Consultar una empresa específica por su identificador. |
## Negocio (Deal / Oportunidad)
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo negocio en Salesforce CRM, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un negocio existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un negocio existente en Salesforce CRM. |
| *List* | Listar múltiples negocios según los filtros disponibles. |
| *Get* | Consultar un negocio específico por su identificador. |
## Pipeline
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------ |
| *Remove* | Eliminar un pipeline existente en Salesforce CRM. |
| *List* | Listar múltiples pipelines disponibles. |
| *Get* | Consultar un pipeline específico por su identificador. |
# ¿Cómo usar las herramientas de Treble para Salesforce?
La integración de Salesforce con Treble hace uso de el asistente de IA "Automatizar tareas complejas" para ejecutar las acciones de las herramientas de Treble para Salesforce. Para ello, es indispensable que sepas cómo usar el asistente de IA "Automatizar tareas complejas" en Treble y cómo configurar las herramientas de Treble para Salesforce.
Si necesitas más información sobre cómo usar el asistente de IA "Automatizar tareas complejas" en Treble, puedes consultar la documentación de "Automatizar tareas complejas" en Treble en el siguiente enlace:
Aprende a usar el asistente de IA "Automatizar tareas complejas" en Treble.
# Configuración de las herramientas de Treble para Salesforce
Para configurar las herramientas de Treble para Salesforce, debes seguir los siguientes pasos:
1. Ingresa a la sección de "Agentes de IA" en Treble.
2. Crea un nuevo agente de IA.
3. Selecciona la opción de "Automatizar tareas complejas".
4. En la sección de "Herramientas", selecciona la herramienta de "Aplicaciones Conectadas".
5. En la sección de "Aplicaciones Conectadas", selecciona la aplicación de "Salesforce".
6. En la sección de "Herramientas", selecciona la herramienta de "Salesforce" que deseas configurar.
Este proceso es el mismo para todas las herramientas listadas de Treble para Salesforce. Sin embargo, cada herramienta tiene sus propias configuraciones. Explicaremos las configuraciones de cada herramienta a continuación.
## Herramienta Buscar Lead o Contacto por Teléfono
Dentro de las herramientas listadas de Treble para Salesforce, existe la herramienta "Buscar Lead o Contacto por Teléfono". Esta herramienta te permite buscar Leads o Contactos por teléfono. La herramienta automáticamente busca el Lead o Contacto en Salesforce CRM según el teléfono de WhatsApp del cliente que esta interactuando con tu asistente de IA por medio de una linea de WhatsApp conectada a Treble. No es necesario que tu asistente de IA tenga que preguntar por el teléfono del cliente, la herramienta lo hará automáticamente.
Has click en la opción que desees configurar entre buscar Lead o Contacto por teléfono. Una vez hayas dado click, esta herramienta no tiene más configuraciones, en los siguientes dos pasos has click en "Siguiente Paso" y finalmente has click en "Guardar Configuración". Verás la herramienta añadida dentro de las instrucciones de tu asistente de IA.
### Formato del teléfono en Salesforce y propiedades
Treble utiliza el formato de teléfono internacional para buscar Leads o Contactos en Salesforce CRM. Por ejemplo, si el teléfono del cliente es del país Estados Unidos y el teléfono es `(917) 555-0111`, Treble lo buscará en Salesforce CRM como `+19175550111`. Treble hará la búsqueda dentro de la propiedad `Phone` en Salesforce CRM.
Ten en cuenta que, en últimas, el agente de IA es quien decide en qué formato realizar la búsqueda. Por defecto, el agente intentará buscar en formato internacional. Sin embargo, si en tu Salesforce CRM los teléfonos no están guardados en formato internacional, puedes indicarle al agente dentro de sus instrucciones (prompt) qué formato debe usar para hacer la búsqueda.
Ejemplos de instrucciones para el agente de IA:
* Colombia: "Cuando uses la herramienta de buscar Lead o Contacto por teléfono, busca primero en formato local de Colombia (por ejemplo, `3001234567`) y, si no encuentras resultados, intenta en formato internacional (`+573001234567`)."
* Argentina: "Cuando busques por teléfono en Salesforce CRM, prioriza formato local de Argentina (por ejemplo, `1151234567` o `3515123456`). Si no hay coincidencias, intenta formato internacional (`+541151234567` o `+543515123456`)."
* Brasil: "Para buscar Leads o Contactos por teléfono, usa primero formato local de Brasil (por ejemplo, `11987654321`). Si no hay resultados, prueba también formato internacional (`+5511987654321`)."
## Herramientas con Opciones de Configuración
Para las demás herramientas, como Crear Lead, Actualizar Contacto, Crear Empresa, Crear Negocio, Buscar (Get) un Pipeline, etc., estas herramientas tienen opciones de configuración. Estas opciones de configuración te permiten interactuar con propiedades de esas entidades. Estas propiedades pueden ser estándar o personalizadas. Miremos algunos ejemplos de configuraciones de herramientas.
### Ejemplo Crear Lead
La herramienta "Crear Lead" te permite crear un nuevo lead en Salesforce CRM. Para configurar esta herramienta, debes seguir los siguientes pasos:
1. Activa la vista de herramientas de Salesforce dentro de la sección de "Herramientas" de tu asistente de IA.
2. Has click en la herramienta de "Create CRM Lead".
3. En esta vista selecciona las propiedades que deseas configurar para el lead. Puedes seleccionar propiedades estándar o personalizadas. En este ejemplo, vamos a seleccionar las propiedades "Name", "Emails", "Telephone" y "Status".
4. Haz click en "Siguiente Paso". En la vista "Parámetros manejados por Agente IA" debes seleccionar qué propiedades quieres que el agente de IA complete dinámicamente durante la conversación.
Cuando una propiedad está marcada como "manejada por Agente IA", el agente intentará extraer ese valor del contexto del chat (por ejemplo, nombre, email o teléfono). Si no encuentra el dato con suficiente claridad, hará una pregunta al cliente para completarlo antes de ejecutar la herramienta.
Para obtener mejores resultados, define instrucciones explícitas en el prompt del agente sobre qué campos debe recopilar y cómo debe hacerlo. Ejemplo recomendado: "Cuando uses la herramienta Crear Lead, intenta extraer `Name`, `Emails` y `Telephone` del contexto de la conversación. Si falta alguno, solicítalo al cliente de forma breve y luego crea el Lead."
En esta vista marca solo los campos variables. Los campos que quieras fijar con un valor predefinido (por ejemplo, `Status = Lead`) puedes dejarlos sin seleccionar aquí y configurarlos en la siguiente sección.
En este caso vamos a seleccionar las propiedades "Name", "Emails" y "Telephone". (Dejamos sin seleccionar la propiedad "Status" para configurarla en la siguiente sección.)
5. En la siguiente vista, vamos a configurar los campos donde el Lead se debería crear con algunas propiedades predefinidas. Por ejemplo, si deseas que el lead se cree con el estado "Lead", vamos a escribir en el campo "Status" el valor "Lead". Esto lo puedes configurar con múltiples propiedades, es decir, puedes configurar varias propiedades con un valor predefinido, lo importante es no seleccionarlas dentro de la vista "Parámetros manejados por Agente IA".
¡Felicitaciones! Ya has configurado la herramienta Crear Lead.
# Conclusiones Finales
Este ejemplo de configuración de la herramienta **Crear Lead** y de sus parámetros aplica de forma idéntica para las demás herramientas de Salesforce y sus opciones de configuración. La lógica es la misma: definir qué propiedades se completan con datos extraídos por el agente de IA, cuáles se dejan como valores predefinidos y cómo se ejecuta la acción según la entidad. Esto aplica en casos como **List Pipeline**, **Get Contact**, **Update Deal**, **Create Company**, entre otros.
# Instalación de la integración con Salesforce AI
Source: https://help.treble.ai/es/docs/integrations/salesforce/salesforce-ai/installation
Esta guía te muestra cómo instalar la integración de Treble con Salesforce.
Para instalar la integración de tu producto con Salesforce, es crucial que el usuario tenga permisos de administrador en la cuenta de Salesforce.
# Pasos para instalar la integración de Salesforce en Treble
1. Inicia sesión en
2. Dirígete a Configuración
3. Dirígete a Integraciones
4. Haz clic en la pestaña de "Aplicaciones Conectadas"
En este punto vamos a seguir las instrucciones. Has click en el botón de "Conectar Aplicación" y se te abrirá un modal con las opciones de conexión. Has click en "Salesforce".
Al hacer click en "Salesforce", serás redirigido a la pantalla de inicio de sesión de Salesforce. Ingresa tus credenciales de administrador y autoriza el acceso de Treble a tu cuenta de Salesforce.
Ya conectaste la aplicación de Salesforce en Treble.
Ahora puedes usar las herramientas de Salesforce para la IA en Treble. Para ello, ve a la sección de "Agentes de IA" y crea un nuevo agente de IA. Debes seleccionar la opción de "Automatizar tareas complejas". Después de crear el agente, ve a la sección de "Herramientas" y selecciona en la lista de herramientas la opción de "Aplicaciones Conectadas". En esta sección, selecciona la aplicación de "Salesforce" y verás las herramientas disponibles para usar en la IA.
¡Felicitaciones! Ya lograste instalar la integración de Salesforce en Treble.
En la siguiente sección, te explicamos cómo usar las herramientas de Salesforce para la IA en Treble.
# Integración con Salesforce AI
Source: https://help.treble.ai/es/docs/integrations/salesforce/salesforce-ai/welcome
Esta guía te muestra cómo integrar Treble con Salesforce y la funcionalidad de IA
Treble te ayuda a aprovechar todo el potencial de WhatsApp para vender más de forma integrada con Salesforce y con IA. La integración de Salesforce AI te permite conectar Salesforce CRM con Treble para actualizar y consultar información de tus entidades en Salesforce CRM desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Lead, Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline.
## Funcionalidades
1. Actualizar información de tus entidades en Salesforce CRM
* Puedes actualizar información de Lead, Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline en Salesforce CRM, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
2. Obtener información de tus entidades para usar en tus conversaciones en Treble
* Puedes obtener información de Lead, Contacto, Empresa (Company), Negocio (Deal / Oportunidad) y Pipeline para usar en tus conversaciones en Treble, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
3. Crear entidades en Salesforce CRM
* Puedes crear Leads, Contactos, Empresas (Company) y Negocios (Deal / Oportunidad) en Salesforce CRM con propiedades estándar y personalizadas.
4. Eliminar entidades en Salesforce CRM
* Puedes eliminar Leads, Contactos, Empresas (Company) y Negocios (Deal / Oportunidad) en Salesforce CRM.
## Ejemplos de uso
1. Tus clientes te contactan por WhatsApp, nuestro asistente de IA responde preguntas frecuentes de tus clientes, revisa si el Lead existe en Salesforce CRM, si no, lo crea y transfiere la conversación a un agente de tu equipo en Treble.
2. Tu cliente quiere actualizar información de su cuenta, el agente de IA puede hacer las preguntas necesarias para actualizar datos del Lead o Contacto en Salesforce CRM.
3. Tu cliente te contacta porque necesita ayuda con su potencial compra de un producto, el agente de IA puede revisar el Negocio (Deal / Oportunidad) en Salesforce CRM y actualizar su estado e información.
4. Tu equipo comercial necesita visibilidad del avance de ventas, el agente de IA puede consultar el Pipeline en Salesforce CRM para identificar en qué etapa está cada Negocio y guiar la siguiente acción en la conversación.
# Preguntas Frecuentes
Source: https://help.treble.ai/es/docs/integrations/sheets/faq
Acá te compartimos algunas de las preguntas más frecuentes y sus respuestas acerca de nuestra integración con Google Sheets.
### **¿Cómo guardar un registro diferente por cada conversación?**
* Agrega una columna llamada `treble_session_id`. Esto permite que cada conversación se guarde como un registro separado.
### **¿Cómo llega la información a la hoja?**
Cuando un cliente responde, la hoja actualiza automáticamente la columna que coincide con el nombre de la variable.
* Si la pregunta es **abierta**, se guarda el texto que escribió el usuario.
* Si la pregunta es **cerrada**, se guarda la opción elegida.
> 💡 Si no existe una columna con el mismo nombre de la variable, no se actualizará.
### **¿Y si el contacto no está en la hoja?**
Si el número del cliente **no existe**, se agregará en la **primera fila vacía disponible**.\
Asegúrate de tener siempre filas vacías al final del documento.
### **¿Funciona en conversaciones inbound?**
Sí. Mientras la hoja tenga el formato y los permisos correctos, también funciona para mensajes entrantes **inbound**.
### **¿Cómo debo escribir el `country_code`?**
Se admite con o sin el signo **+**:
Ejemplo: `+57` o `57`
### **¿Por qué no se guarda el valor en Sheets?**
Las causas más comunes son:
1. **El usuario existe, pero la columna no coincide.**\
Verifica que el nombre de la columna sea exactamente igual al de la variable.
2. **El usuario no existe y no hay espacio.**\
Google Sheets tiene un límite inicial de **1000 filas**.\
Si llegas al tope, debes agregar más filas manualmente.
> ⚠️ **Importante:**\
> Siempre deben existir las columnas `country_code` y `cellphone`.
### **Variable inbound**
* No incluyas el prefijo `sheets_` en el nombre.
* Solo funciona para **mensajes de texto entrantes**, no para archivos o media.
### **Consejos finales**
* Usa nombres de columnas **cortos y claros**.
* Mantén tu hoja organizada (sin filas vacías entre contactos).
* Verifica los permisos antes de probar la integración.
# Integración de Treble.ai con Google Sheets
Source: https://help.treble.ai/es/docs/integrations/sheets/welcome
Conecta tus conversaciones con hojas de cálculo para guardar y actualizar datos automáticamente.
¡Hola!
En esta guia aprenderás como conectar **Treble** con **Google Sheets** para **actualizar** y **obtener variables** desde una hoja de cálculo de Google.
Esta integración te permite automatizar la gestión de datos de tus conversaciones en Treble usando una hoja de Google Sheets como base de datos.
## Activar la integracion
1. Crea una hoja de cálculo en **Google Sheets**.
*Recomendado:* déjala con **permiso público para editar**.
Si prefieres mantenerla privada, más abajo encontrarás las instrucciones para
hacerlo.
2. En el **Editor de Flujos de Conversación** de Treble, haz click en el ícono del rompecabezas .
3. Selecciona la opción **Google Sheets**.
4. Pega la **URL** de tu hoja de cálculo en el campo de texto.
## Formato requerido en la hoja
Esta integración requiere que tu hoja de cálculo tenga las siguientes dos columnas en la primera fila:
`country_code` y `cellphone` que se usan para identificar a cada usuario. Las siguientes columnas se usan para obtener o guardar información sobre ese usuario.
## Consultar variables desde Sheets
Para **obtener una variable** desde la hoja de cálculo, debes usar el siguiente formato dentro de la conversación:
`sheets_nombre_variable`
Por ejemplo, si tienes una columna `name`, puedes usar la variable `sheets_name` para saludar al usuario:
```text theme={null}
Hola {{sheets_name}}, ¿cómo estás?
```
## Guardar respuestas en Sheets
Para guardar lo que el usuario responde en la conversación, usa el mismo formato de variable `sheets_nombre_variable`, y marca la opción **"Guardar respuesta como variable"** en el flujo.
## Guardar la hora de la respuesta
Si quieres registrar cuándo se guardó una respuesta, crea otra columna con el prefijo `time_`
Por ejemplo:
* Si tienes la variable `name`, crea otra columna llamada `time_name`.
Treble guardará automáticamnete la fecha y hora cuando el usuario responda.
## Hojas con permisos restringidos
Si no quieres que tu hoja sea pública, debes compartirla con **los tres correos oficiales de Treble**:
```text theme={null}
treble-sheets@treble-ai.iam.gserviceaccount.com
treble-sheets@treble-ai-2.iam.gserviceaccount.com
treble@treble-ai-sheets.iam.gserviceaccount.com
```
## Limitaciones
* **Máximo de columnas soportadas**: hasta la columna ZZ.
* **Límites de velocidad `rate limit` de Google Sheets**:
* G Suite: 5 solicitudes por segundo
* Gmail normal: 1 solicitud por segundo
Si se superan esos límites, es posible que algunos datos se pierdan.
# Ejemplos de uso de la integración con Zoho
Source: https://help.treble.ai/es/docs/integrations/zoho/examples
Esta guía te algunas recetas de escenarios y casos de uso de la integración de Treble con Zoho.
Este artículo muestra un escenario real para usar Zoho CRM con Treble desde un agente de IA: validar si el cliente ya existe en el CRM, crearlo si no existe, actualizar sus datos, crear un negocio (Deal / Oportunidad) y transferir la conversación a un agente humano.
## Escenario práctico: calificación y handoff a ventas
Imagina que tus clientes te escriben por WhatsApp para pedir información comercial. Tu objetivo es automatizar este flujo:
1. Revisar si el cliente ya está registrado en Zoho CRM como **Lead** o **Contacto**.
2. Si no existe, crearlo en Zoho CRM y registrar los datos básicos.
3. Actualizar información adicional del Lead/Contacto durante la conversación.
4. Crear un **Negocio (Deal / Oportunidad)** con información de cotización.
5. Transferir la conversación a un agente humano en Treble.
## Herramientas que intervienen
En este escenario puedes combinar herramientas como:
* Búsqueda de Lead/Contacto por teléfono.
* `create_crm_lead` o `create_crm_contact` para registrar al cliente.
* `update_crm_lead` o `update_crm_contact` para completar campos faltantes.
* `create_crm_deal` para crear la oportunidad comercial.
* `transferToAgent` para handoff al equipo humano.
## Prompt recomendado (ejemplo completo)
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Zoho CRM antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Lead por teléfono usando:
\[PLACEHOLDER\_TOOL\_CALL\_SEARCH\_LEAD\_BY\_PHONE]
2. Si no existe Lead, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Lead usando:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_LEAD]
3. Si el Lead ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
\[PLACEHOLDER\_TOOL\_CALL\_UPDATE\_LEAD]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
\[PLACEHOLDER\_TOOL\_CALL\_CREATE\_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
\[PLACEHOLDER\_TOOL\_CALL\_TRANSFER\_TO\_AGENT]
### Reglas de comportamiento
* Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
* No inventes datos: solo guarda en CRM lo confirmado por el cliente.
* Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
* Si detectas que el cliente ya existe como Contacto y no como Lead, continúa el flujo usando Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```text theme={null}
Eres un asistente de IA comercial. Tu objetivo es atender prospectos por WhatsApp y registrar toda la información relevante en Zoho CRM antes de transferir la conversación al equipo humano.
### Flujo obligatorio
1. Primero revisa si existe un Lead por teléfono usando:
[PLACEHOLDER_TOOL_CALL_SEARCH_LEAD_BY_PHONE]
2. Si no existe Lead, solicita nombre, correo y teléfono al cliente. Cuando tengas esos datos, crea el Lead usando:
[PLACEHOLDER_TOOL_CALL_CREATE_LEAD]
3. Si el Lead ya existe o fue creado, recolecta el interés principal del cliente y actualiza el registro con:
[PLACEHOLDER_TOOL_CALL_UPDATE_LEAD]
4. Después de validar interés y contexto comercial, crea un Deal/Oportunidad con:
[PLACEHOLDER_TOOL_CALL_CREATE_DEAL]
5. Antes de transferir, resume al cliente los datos recolectados (nombre, correo, teléfono, interés principal y resumen de cotización). Luego transfiere al equipo de ventas con:
[PLACEHOLDER_TOOL_CALL_TRANSFER_TO_AGENT]
### Reglas de comportamiento
- Si falta información crítica para crear o actualizar registros, pregunta de forma breve y directa.
- No inventes datos: solo guarda en CRM lo confirmado por el cliente.
- Prioriza consistencia en formato de teléfono. Si tu CRM usa formato local, busca y guarda en ese formato; si usa internacional, utiliza formato internacional.
- Si detectas que el cliente ya existe como Contacto y no como Lead, continúa el flujo usando Contacto sin duplicar registros.
### Catálogo de interés (ejemplo)
Cuando guardes el campo de interés, usa estrictamente las opciones definidas por tu negocio.
```
## Recomendaciones para adaptar este ejemplo
* Ajusta nombres de campos (`slug`) según tus propiedades reales en Zoho CRM.
* Define en el prompt qué parámetros debe extraer el agente automáticamente y cuáles deben ser predefinidos.
* Si tu operación usa Contacto en vez de Lead, reemplaza herramientas de Lead por Contacto en el mismo flujo.
* Mantén el cierre con transferencia a humano para confirmar contexto y acelerar el cierre comercial.
Este patrón aplica para múltiples casos: captación de leads, calificación comercial, actualización de CRM y handoff a equipos humanos.
# Funcionalidades de la integración con Zoho
Source: https://help.treble.ai/es/docs/integrations/zoho/features
Esta guía te muestra cómo usar las funcionalidades de la integración de Treble con Zoho.
La integración de Zoho con Treble te permite interactuar con múltiples entidades en Zoho CRM desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline.
Con estas entidades, las herramientas de la integración te permiten ejecutar distintas acciones según el tipo de entidad. En Lead, Contacto y Negocio (Deal / Oportunidad) puedes crear, actualizar, eliminar, listar y consultar registros individuales. En Pipeline puedes consultar uno, listar varios o eliminar.
# Acciones disponibles por entidad
## Lead
| Acción | ¿Qué puedes hacer? |
| -------- | ---------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo lead en Zoho CRM, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un lead existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un lead existente en Zoho CRM. |
| *List* | Listar múltiples leads según los filtros disponibles. |
| *Get* | Consultar un lead específico por su identificador. |
## Contacto
| Acción | ¿Qué puedes hacer? |
| -------- | -------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo contacto en Zoho CRM, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un contacto existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un contacto existente en Zoho CRM. |
| *List* | Listar múltiples contactos según los filtros disponibles. |
| *Get* | Consultar un contacto específico por su identificador. |
## Negocio (Deal / Oportunidad)
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------------------------------------- |
| *Create* | Crear un nuevo negocio en Zoho CRM, incluyendo propiedades estándar y personalizadas. |
| *Update* | Actualizar un negocio existente, incluyendo propiedades estándar y personalizadas. |
| *Remove* | Eliminar un negocio existente en Zoho CRM. |
| *List* | Listar múltiples negocios según los filtros disponibles. |
| *Get* | Consultar un negocio específico por su identificador. |
## Pipeline
| Acción | ¿Qué puedes hacer? |
| -------- | ------------------------------------------------------ |
| *Remove* | Eliminar un pipeline existente en Zoho CRM. |
| *List* | Listar múltiples pipelines disponibles. |
| *Get* | Consultar un pipeline específico por su identificador. |
# ¿Cómo usar las herramientas de Treble para Zoho?
La integración de Zoho con Treble hace uso de el asistente de IA "Automatizar tareas complejas" para ejecutar las acciones de las herramientas de Treble para Zoho. Para ello, es indispensable que sepas cómo usar el asistente de IA "Automatizar tareas complejas" en Treble y cómo configurar las herramientas de Treble para Zoho.
Si necesitas más información sobre cómo usar el asistente de IA "Automatizar tareas complejas" en Treble, puedes consultar la documentación de "Automatizar tareas complejas" en Treble en el siguiente enlace:
Aprende a usar el asistente de IA "Automatizar tareas complejas" en Treble.
# Configuración de las herramientas de Treble para Zoho
Para configurar las herramientas de Treble para Zoho, debes seguir los siguientes pasos:
1. Ingresa a la sección de "Agentes de IA" en Treble.
2. Crea un nuevo agente de IA.
3. Selecciona la opción de "Automatizar tareas complejas".
4. En la sección de "Herramientas", selecciona la herramienta de "Aplicaciones Conectadas".
5. En la sección de "Aplicaciones Conectadas", selecciona la aplicación de "Zoho".
6. En la sección de "Herramientas", selecciona la herramienta de "Zoho" que deseas configurar.
Este proceso es el mismo para todas las herramientas listadas de Treble para Zoho. Sin embargo, cada herramienta tiene sus propias configuraciones. Explicaremos las configuraciones de cada herramienta a continuación.
## Herramienta Buscar Lead o Contacto por Teléfono
Dentro de las herramientas listadas de Treble para Zoho, existe la herramienta "Buscar Lead o Contacto por Teléfono". Esta herramienta te permite buscar Leads o Contactos por teléfono. La herramienta automáticamente busca el Lead o Contacto en Zoho CRM según el teléfono de WhatsApp del cliente que esta interactuando con tu asistente de IA por medio de una linea de WhatsApp conectada a Treble. No es necesario que tu asistente de IA tenga que preguntar por el teléfono del cliente, la herramienta lo hará automáticamente.
Has click en la opción que desees configurar entre buscar Lead o Contacto por teléfono. Una vez hayas dado click, esta herramiento no tiene más configuraciones, en los siguientes dos pasos has click en "Siguiente Paso" y finalmente has click en "Guardar Configuración". Verás la herramienta añadida dentro de las instrucciones de tu asistente de IA.
### Formato del teléfono en Zoho y propiedades
Treble utiliza el formato de teléfono internacional para buscar Leads o Contactos en Zoho CRM. Por ejemplo, si el teléfono del cliente es del país Estados Unidos y el teléfono es `(917) 555-0111`, Treble lo buscará en Zoho CRM como `+19175550111`. Treble hará la búsqueda dentro de la propiedad `Phone` en Zoho CRM.
Ten en cuenta que, en ultimas, el agente de IA es quien decide en qué formato realizar la busqueda. Por defecto, el agente intentará buscar en formato internacional. Sin embargo, si en tu Zoho CRM los telefonos no están guardados en formato internacional, puedes indicarle al agente dentro de sus instrucciones (prompt) qué formato debe usar para hacer la busqueda.
Ejemplos de instrucciones para el agente de IA:
* Colombia: "Cuando uses la herramienta de buscar Lead o Contacto por telefono, busca primero en formato local de Colombia (por ejemplo, `3001234567`) y, si no encuentras resultados, intenta en formato internacional (`+573001234567`)."
* Argentina: "Cuando busques por telefono en Zoho CRM, prioriza formato local de Argentina (por ejemplo, `1151234567` o `3515123456`). Si no hay coincidencias, intenta formato internacional (`+541151234567` o `+543515123456`)."
* Brasil: "Para buscar Leads o Contactos por telefono, usa primero formato local de Brasil (por ejemplo, `11987654321`). Si no hay resultados, prueba tambien formato internacional (`+5511987654321`)."
## Herramientas con Opciones de Configuración
Para las demás herramientas, como Crear Lead, Actualizar Contacto, Crear Negocio, Buscar (Get) un Pipeline, etc., estas herramientas tienen opciones de configuración. Estas opciones de configuración te permiten interactuar con propiedades de esas entidades. Estas propiedades pueden ser estándar o personalizadas. Miremos algunos ejemplos de configuraciones de herramientas.
### Ejemplo Crear Lead
La herramienta "Crear Lead" te permite crear un nuevo lead en Zoho CRM. Para configurar esta herramienta, debes seguir los siguientes pasos:
1. Activa la vista de herramientas de Zoho dentro de la sección de "Herramientas" de tu asistente de IA.
2. Has click en la herramienta de "Create CRM Lead".
3. En esta vista selecciona las propiedades que deseas configurar para el lead. Puedes seleccionar propiedades estándar o personalizadas. En este ejemplo, vamos a seleccionar las propiedades "Name", "Emails", "Telephone" y "Status".
4. Haz click en "Siguiente Paso". En la vista "Parámetros manejados por Agente IA" debes seleccionar qué propiedades quieres que el agente de IA complete dinámicamente durante la conversación.
Cuando una propiedad está marcada como "manejada por Agente IA", el agente intentará extraer ese valor del contexto del chat (por ejemplo, nombre, email o teléfono). Si no encuentra el dato con suficiente claridad, hará una pregunta al cliente para completarlo antes de ejecutar la herramienta.
Para obtener mejores resultados, define instrucciones explícitas en el prompt del agente sobre qué campos debe recopilar y cómo debe hacerlo. Ejemplo recomendado: "Cuando uses la herramienta Crear Lead, intenta extraer `Name`, `Emails` y `Telephone` del contexto de la conversación. Si falta alguno, solicítalo al cliente de forma breve y luego crea el Lead."
En esta vista marca solo los campos variables. Los campos que quieras fijar con un valor predefinido (por ejemplo, `Status = Lead`) puedes dejarlos sin seleccionar aquí y configurarlos en la siguiente sección.
En este caso vamos a seleccionar las propiedades "Name", "Emails" y "Telephone". (Dejamos sin seleccionar la propiedad "Status" para configurarla en la siguiente sección.)
5. En la siguiente vista, vamos a configurar los campos donde el Lead se debería crear con algunas propiedades predefinidas. Por ejemplo, si deseas que el lead se cree con el estado "Lead", vamos a escribir en el campo "Status" el valor "Lead". Esto lo puedes configurar con múltiples propiedades, es decir, puedes configurar varias propiedades con un valor predefinido, lo importante es no seleccionarlas dentro de la vista "Parámetros manejados por Agente IA".
¡Felicitaciones! Ya has configurado la herramienta Crear Lead.
# Conclusiones Finales
Este ejemplo de configuración de la herramienta **Crear Lead** y de sus parámetros aplica de forma idéntica para las demás herramientas de Zoho y sus opciones de configuración. La lógica es la misma: definir qué propiedades se completan con datos extraídos por el agente de IA, cuáles se dejan como valores predefinidos y cómo se ejecuta la acción según la entidad. Esto aplica en casos como **List Pipeline**, **Get Contact**, **Update Deal**, entre otros.
# Instalación de la integración con Zoho
Source: https://help.treble.ai/es/docs/integrations/zoho/installation
Esta guía te muestra cómo instalar la integración de Treble con Zoho.
Para instalar la integración de tu producto con Zoho, es crucial que el usuario tenga permisos de administrador en la cuenta de Zoho.
# Pasos para instalar la integración de Zoho en Treble
1. Inicia sesión en
2. Dirígete a Configuración
3. Dirígete a Integraciones
4. Haz clic en la pestaña de "Aplicaciones Conectadas"
En este punto vamos a seguir las instrucciones. Has click en el botón de "Conectar Aplicación" y se te abrirá un modal con las opciones de conexión. Has click en "Zoho".
Al hacer click en "Zoho", se te abrirá una ventana de configuración de Zoho. Has click en la caja de "Permitirle a Treble.ai acceso a la data listada". Y luego has click en "Aceptar".
Ya conectaste la aplicación de Zoho en Treble.
Ahora puedes usar las herramientas de Zoho para la IA en Treble. Para ello, ve a la sección de "Agentes de IA" y crea un nuevo agente de IA. Debes seleccionar la opción de "Automatizar tareas complejas". Después de crear el agente, ve a la sección de "Herramientas" y selecciona en la lista de herramientas la opción de "Aplicaciones Conectadas". En esta sección, selecciona la aplicación de "Zoho" y verás las herramientas disponibles para usar en la IA.
¡Felicitaciones! Ya lograste instalar la integración de Zoho en Treble.
En la siguiente sección, te explicamos cómo usar las herramientas de Zoho para la IA en Treble.
# Integración con Zoho
Source: https://help.treble.ai/es/docs/integrations/zoho/welcome
Esta guía te muestra cómo integrar Treble con Zoho.
Treble te ayuda a aprovechar todo el potencial de WhatsApp para vender más de forma integrada con Zoho y con IA. La integración de Zoho te permite conectar Zoho CRM con Treble para actualizar y consultar información de tus entidades en Zoho CRM desde tus conversaciones en Treble. Las entidades disponibles para interactuar con la integración son: Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline.
## Funcionalidades
1. Actualizar información de tus entidades en Zoho CRM
* Puedes actualizar información de Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline en Zoho CRM, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
2. Obtener información de tus entidades para usar en tus conversaciones en Treble
* Puedes obtener información de Lead, Contacto, Negocio (Deal / Oportunidad) y Pipeline para usar en tus conversaciones en Treble, como por ejemplo, nombre, email, teléfono, etapa, estado, etc. También puedes usar propiedades personalizadas de estas entidades.
3. Crear entidades en Zoho CRM
* Puedes crear Leads, Contactos y Negocios (Deal / Oportunidad) en Zoho CRM con propiedades estándar y personalizadas.
4. Eliminar entidades en Zoho CRM
* Puedes eliminar Leads, Contactos y Negocios (Deal / Oportunidad) en Zoho CRM.
## Ejemplos de uso
1. Tus clientes te contactan por WhatsApp, nuestro asistente de IA responde preguntas frecuentes de tus clientes, revisa si el Lead existe en Zoho CRM, si no, lo crea y transfiere la conversación a un agente de tu equipo en Treble.
2. Tu cliente quiere actualizar información de su cuenta, el agente de IA puede hacer las preguntas necesarias para actualizar datos del Lead o Contacto en Zoho CRM.
3. Tu cliente te contacta porque necesita ayuda con su potencial compra de un producto, el agente de IA puede revisar el Negocio (Deal / Oportunidad) en Zoho CRM y actualizar su estado e información.
4. Tu equipo comercial necesita visibilidad del avance de ventas, el agente de IA puede consultar el Pipeline en Zoho CRM para identificar en qué etapa está cada Negocio y guiar la siguiente acción en la conversación.