> ## Documentation Index
> Fetch the complete documentation index at: https://help.ciarem.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Enviar WhatsApp desde un workflow de HubSpot

> Agrega la acción Enviar una plantilla de WhatsApp a un workflow de HubSpot, para que cada registro inscrito reciba una plantilla de WhatsApp aprobada desde Ciarem.

Una vez que [HubSpot está conectado](https://help.ciarem.ai/es/integrations/hubspot.md), tus workflows de HubSpot tienen una acción de Ciarem llamada **Enviar una plantilla de WhatsApp**. Cuando un contacto llega a ella, Ciarem le envía una [plantilla](https://help.ciarem.ai/es/channels/message-templates.md) de WhatsApp aprobada. En un workflow de empresas o de negocios, se envía a los contactos asociados al registro.

Úsala para escribirle a un contacto cuando algo pasa en HubSpot: se convierte en lead, su negocio cambia de etapa o su reunión es mañana.

## Antes de empezar

* HubSpot está conectado a Ciarem y su configuración está terminada. Consulta [HubSpot](https://help.ciarem.ai/es/integrations/hubspot.md).
* Tienes al menos un [número de WhatsApp](https://help.ciarem.ai/es/channels/connect-whatsapp.md) conectado y una plantilla aprobada.
* Tu plan de HubSpot incluye workflows, y puedes crearlos y editarlos. Si no los incluye, [envía a una lista de HubSpot](https://help.ciarem.ai/es/integrations/hubspot/lists.md).

## Agregar la acción a un workflow

**1. Abre o crea un workflow**

En HubSpot, ve a **Automatización** y luego a **Workflows**. Abre un workflow, o crea uno basado en contactos, empresas o negocios y define sus activadores de inscripción.

**2. Agrega la acción de Ciarem**

Haz clic en **+** donde debe ir el mensaje. En **Elegir una acción**, ve a **Aplicaciones integradas**, abre **Ciarem** y elige **Enviar una plantilla de WhatsApp**.

**3. Elige quién lo recibe**

**Target record** (HubSpot muestra este campo en inglés) empieza en **contacto inscrito/a**, que envía al contacto que el workflow inscribió. Para enviar a los contactos de un registro relacionado, elige **Empresa: Actualizado más recientemente** o **Negocio: Actualizado más recientemente**. Consulta [Empresas y negocios](#empresas-y-negocios).

**4. Elige el número de WhatsApp**

En **Número de WhatsApp**, elige el número de Ciarem desde el que se envía el mensaje.

**5. Elige la plantilla**

En **Plantilla**, elige una de las plantillas aprobadas de ese número. Cada plantilla muestra su idioma y su categoría, y los nombres de sus variables si tiene.

**6. Completa las variables, si la plantilla tiene**

En **Valores de las variables (JSON)**, da un valor por variable, usando como clave el nombre o el número de la variable. Un valor es un texto fijo, o una propiedad del contacto como `{{contact.first_name}}` que se completa con los datos de cada contacto.

```json theme={null}
{
  "1": "{{contact.first_name}}",
  "2": "lunes a las 10:00"
}
```

Deja el cuadro vacío cuando la plantilla no tiene variables.

![La acción Enviar una plantilla de WhatsApp en un workflow de HubSpot, con Target record, Número de WhatsApp, Plantilla y Valores de las variables (JSON) completos](https://mintcdn.com/ciaremaai/l19-LBccyXWEl5K9/images/es/ciarem-help-hubspot-workflow-action.png?fit=max\&auto=format\&n=l19-LBccyXWEl5K9\&q=85\&s=9985a7c756f030e1be9b80ed65f92cfc)

**7. Guarda y activa el workflow**

Guarda la acción, revisa el workflow y actívalo. Desde ese momento, cada registro inscrito que llega a este paso recibe la plantilla.

Una propiedad del contacto en una variable sale de los datos que Ciarem sincroniza: el nombre, el teléfono y el correo del contacto, más las propiedades que elegiste en [Asignación de propiedades](https://help.ciarem.ai/es/integrations/hubspot.md#qué-se-sincroniza). Justo antes de enviar, Ciarem vuelve a leer esas propiedades mapeadas desde HubSpot, así que normalmente se envía el valor que cambió un paso anterior del workflow.

## Empresas y negocios

Cuando el workflow está basado en empresas o negocios, o **Target record** es una empresa o un negocio, la acción envía a cada contacto asociado a ese registro, hasta 25. Si el registro tiene más de 25 contactos asociados, nadie recibe el mensaje y el paso falla. Usa un workflow basado en contactos para llegar a todos.

HubSpot muestra un solo resultado para el paso. Cuenta como éxito cuando al menos un contacto recibió el mensaje. Los resultados de la acción listan quién lo recibió (**sentTo**) y quién no, con el motivo (**notSent**).

Los workflows basados en otros registros, como tickets o leads, no ofrecen la acción.

## Qué pasa cuando se ejecuta

* **El paso espera el envío.** HubSpot muestra el paso en curso con la nota "Queued: Ciarem is sending the template and will finish this step shortly." Luego pasa a éxito o a fallo con un motivo. En los dos casos, el workflow sigue con su siguiente acción. Si un paso no terminó en una hora, HubSpot lo marca como fallido, y Ciarem ya no envía el mensaje.
* **Es un mensaje real de WhatsApp.** Se cobra de tu billetera de WhatsApp a la tarifa de Meta, como cualquier plantilla. Consulta [Costos de WhatsApp y la ventana de 24 horas](https://help.ciarem.ai/es/billing/whatsapp-costs-and-templates.md).
* **Aparece en los dos lados.** El envío queda registrado en el timeline del contacto en HubSpot, y el mensaje aparece en la [Bandeja de entrada](https://help.ciarem.ai/es/using-ciarem/inbox.md) de Ciarem.
* **El agente de IA responde.** Si el contacto no tenía una conversación abierta, el mensaje abre una que atiende la IA, así su respuesta recibe contestación al momento. Una conversación abierta se queda con quien la atendía: un compañero, la IA o la app WhatsApp Business.
* **Cada inscripción envía una vez.** Si el workflow permite la reinscripción, un contacto que se inscribe de nuevo vuelve a recibir la plantilla, y se cobra otra vez.
* **Se respetan las bajas.** Las plantillas de marketing no se envían a los contactos que se [dieron de baja del marketing](https://help.ciarem.ai/es/channels/whatsapp-marketing-opt-out.md).

## Si algo no funciona

Cuando un paso falla, abre el historial del workflow en HubSpot y busca el registro inscrito. El paso muestra uno de estos mensajes.

| Lo que ves | Qué hacer |
| - | - |
| La acción no está en el panel de acciones | El workflow no está basado en contactos, empresas o negocios. Créalo sobre uno de ellos. Revisa también que **Ciarem** aparezca en **Configuración > Integraciones > Aplicaciones conectadas** de HubSpot. |
| **Número de WhatsApp** o **Plantilla** no tiene opciones | Ciarem no tiene un número de WhatsApp conectado, o el número no tiene plantillas aprobadas. Revisa ambos en Ciarem. |
| Falta una plantilla en la lista | Solo aparecen las plantillas aprobadas del número elegido. Las plantillas que necesitan un código de botón, un enlace dinámico, una cuenta regresiva o un archivo de encabezado que Ciarem no tiene guardado no se pueden enviar desde HubSpot. |
| **Este portal ya no está conectado a Ciarem.** | Vuelve a conectar HubSpot en Ciarem, en **Configuración > Integraciones > HubSpot**. |
| **Este contacto aún no se ha sincronizado con Ciarem.** | Revisa que tus [filtros de importación](https://help.ciarem.ai/es/integrations/hubspot.md#qué-se-sincroniza) incluyan al contacto. Si el workflow arranca en cuanto se crea un contacto, agrega una espera corta antes de la acción de Ciarem para que el contacto alcance a sincronizarse. Vuelve a inscribir al contacto cuando ya esté sincronizado. |
| **Otro contacto de HubSpot tiene el mismo número de teléfono, correo o usuario de Instagram** | Combina los dos contactos en HubSpot o corrige uno de ellos. El ID del registro del otro contacto está en los detalles del paso. Consulta [Contactos no importados](https://help.ciarem.ai/es/integrations/hubspot.md#contactos-no-importados). |
| **Este contacto no tiene un número de teléfono alcanzable por WhatsApp.** | Agrega el número de WhatsApp del contacto en HubSpot, con su código de país, por ejemplo +52. |
| **La plantilla seleccionada ya no está aprobada o ya no existe.** | Abre la acción y elige otra plantilla. |
| **Una variable de la plantilla no tiene valor** | Da un valor a cada variable en **Valores de las variables (JSON)**, y revisa que el contacto tenga todas las propiedades que usa la plantilla. |
| **La billetera de WhatsApp de Ciarem no tiene saldo suficiente.** | Recarga tu billetera de WhatsApp en Ciarem. Consulta [Planes y facturación](https://help.ciarem.ai/es/billing/plans-and-billing.md). |
| **Esta cuenta de WhatsApp alcanzó el número de conversaciones nuevas que Meta le permite iniciar en 24 horas.** | Espera a que se libere la ventana de 24 horas y vuelve a inscribir a los contactos que no lo recibieron. |
| **El contacto se dio de baja del marketing por WhatsApp** | No hay nada que corregir: el contacto pidió no recibir mensajes de marketing. Consulta [Baja de marketing por WhatsApp](https://help.ciarem.ai/es/channels/whatsapp-marketing-opt-out.md). |
| **Este registro tiene más de 25 contactos asociados.** | Usa un workflow basado en contactos para llegar a todos. |
| **Este registro no tiene contactos asociados a los que enviar.** | Asocia los contactos a la empresa o al negocio en HubSpot. |
| **Ciarem no tiene permiso para leer los contactos de este registro.** | En Ciarem, abre **Configuración > Integraciones > HubSpot** y haz clic en **Dar acceso** en el aviso. |
| **WhatsApp rechazó el mensaje.** | Los detalles del paso traen el motivo de WhatsApp. Si se repite, [reporta un problema](https://help.ciarem.ai/es/getting-started/report-a-problem.md). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.