> ## 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 a partir de um workflow do HubSpot

> Adicione a ação Enviar um modelo de WhatsApp a um workflow do HubSpot, para que cada registro inscrito receba um modelo de WhatsApp aprovado pela Ciarem.

Depois que o [HubSpot está conectado](https://help.ciarem.ai/pt/integrations/hubspot.md), seus workflows do HubSpot ganham uma ação da Ciarem chamada **Enviar um modelo de WhatsApp**. Quando um contato chega a ela, a Ciarem envia a ele um [modelo](https://help.ciarem.ai/pt/channels/message-templates.md) de WhatsApp aprovado. Em um workflow de empresas ou de negócios, o envio vai para os contatos associados ao registro.

Use-a para escrever a um contato quando algo acontece no HubSpot: ele vira lead, o negócio dele muda de etapa ou a reunião dele é amanhã.

## Antes de começar

* O HubSpot está conectado à Ciarem e a configuração dele está concluída. Veja [HubSpot](https://help.ciarem.ai/pt/integrations/hubspot.md).
* Você tem pelo menos um [número de WhatsApp](https://help.ciarem.ai/pt/channels/connect-whatsapp.md) conectado e um modelo aprovado.
* Seu plano do HubSpot inclui workflows, e você pode criá-los e editá-los. Se não incluir, [envie para uma lista do HubSpot](https://help.ciarem.ai/pt/integrations/hubspot/lists.md).

## Adicionar a ação a um workflow

**1. Abra ou crie um workflow**

No HubSpot, vá em **Automação** e depois em **Fluxos de trabalho**. Abra um workflow, ou crie um baseado em contatos, empresas ou negócios e defina os gatilhos de inscrição.

**2. Adicione a ação da Ciarem**

Clique em **+** onde a mensagem deve entrar. Em **Escolha uma ação**, vá em **Aplicativos integrados**, abra **Ciarem** e escolha **Enviar um modelo de WhatsApp**.

**3. Escolha quem recebe**

**Target record** (o HubSpot mostra este campo em inglês) começa em **contato inscrito**, que envia para o contato que o workflow inscreveu. Para enviar aos contatos de um registro relacionado, escolha a empresa ou o negócio atualizado mais recentemente. Veja [Empresas e negócios](#empresas-e-negócios).

**4. Escolha o número de WhatsApp**

Em **Número de WhatsApp**, escolha o número da Ciarem de onde a mensagem é enviada.

**5. Escolha o modelo**

Em **Modelo**, escolha um dos modelos aprovados desse número. Cada modelo mostra o idioma e a categoria, e os nomes das variáveis, se tiver.

**6. Preencha as variáveis, se o modelo tiver**

Em **Valores das variáveis (JSON)**, dê um valor para cada variável, usando como chave o nome ou o número da variável. Um valor é um texto fixo, ou uma propriedade do contato como `{{contact.first_name}}` que é preenchida com os dados de cada contato.

```json theme={null}
{
  "1": "{{contact.first_name}}",
  "2": "segunda-feira às 10:00"
}
```

Deixe a caixa vazia quando o modelo não tiver variáveis.

![A ação Enviar um modelo de WhatsApp em um workflow do HubSpot, com Target record, Número de WhatsApp e Modelo preenchidos](https://mintcdn.com/ciaremaai/ZRdKNXAC0EbSUhL5/images/pt/ciarem-help-hubspot-workflow-action.png?fit=max\&auto=format\&n=ZRdKNXAC0EbSUhL5\&q=85\&s=e6a554c8e4fe9a0897326753730367a7)

**7. Salve e ative o workflow**

Salve a ação, revise o workflow e ative-o. A partir daí, cada registro inscrito que chega a esta etapa recebe o modelo.

Uma propriedade do contato em uma variável vem dos dados que a Ciarem sincroniza: o nome, o telefone e o e-mail do contato, mais as propriedades que você escolheu em [Mapeamento de propriedades](https://help.ciarem.ai/pt/integrations/hubspot.md#o-que-sincroniza). Logo antes de enviar, a Ciarem lê de novo essas propriedades mapeadas no HubSpot, então normalmente é enviado o valor que uma etapa anterior do workflow mudou.

## Empresas e negócios

Quando o workflow é baseado em empresas ou negócios, ou o **Target record** é uma empresa ou um negócio, a ação envia para cada contato associado a esse registro, até 25. Se o registro tiver mais de 25 contatos associados, ninguém recebe a mensagem e a etapa falha. Use um workflow baseado em contatos para alcançar todos.

O HubSpot mostra um único resultado para a etapa. Ela conta como sucesso quando pelo menos um contato recebeu a mensagem. Os resultados da ação listam quem recebeu (**sentTo**) e quem não recebeu, com o motivo (**notSent**).

Workflows baseados em outros registros, como tickets ou leads, não oferecem a ação.

## O que acontece quando ela roda

* **A etapa espera o envio.** O HubSpot mostra a etapa em andamento com a nota "Queued: Ciarem is sending the template and will finish this step shortly." Depois ela vira sucesso ou falha com um motivo. Nos dois casos, o workflow segue para a próxima ação. Se uma etapa não terminar em uma hora, o HubSpot a marca como falha, e a Ciarem não envia mais a mensagem.
* **É uma mensagem real de WhatsApp.** Ela é cobrada da sua carteira de WhatsApp pela tarifa da Meta, como qualquer modelo. Veja [Custos do WhatsApp e a janela de 24 horas](https://help.ciarem.ai/pt/billing/whatsapp-costs-and-templates.md).
* **Aparece nos dois lados.** O envio fica registrado na timeline do contato no HubSpot, e a mensagem aparece na [Caixa de entrada](https://help.ciarem.ai/pt/using-ciarem/inbox.md) da Ciarem.
* **O agente de IA responde.** Se o contato não tinha uma conversa aberta, a mensagem abre uma atendida pela IA, então a resposta dele é respondida na hora. Uma conversa aberta fica com quem a atendia: um colega, a IA ou o app WhatsApp Business.
* **Cada inscrição envia uma vez.** Se o workflow permitir reinscrição, um contato que se inscreve de novo recebe o modelo de novo, e é cobrado de novo.
* **Os descadastros são respeitados.** Modelos de marketing não são enviados a contatos que se [descadastraram do marketing](https://help.ciarem.ai/pt/channels/whatsapp-marketing-opt-out.md).

## Se algo não estiver funcionando

Quando uma etapa falha, abra o histórico do workflow no HubSpot e encontre o registro inscrito. A etapa mostra uma destas mensagens.

| O que você vê | O que fazer |
| - | - |
| A ação não está no painel de ações | O workflow não é baseado em contatos, empresas ou negócios. Crie-o sobre um deles. Confira também se a **Ciarem** aparece em **Configurações > Integrações > Aplicativos conectados** do HubSpot. |
| **Número de WhatsApp** ou **Modelo** não tem opções | A Ciarem não tem um número de WhatsApp conectado, ou o número não tem modelos aprovados. Verifique os dois na Ciarem. |
| Falta um modelo na lista | Só aparecem os modelos aprovados do número escolhido. Modelos que precisam de um código de botão, um link dinâmico, uma contagem regressiva ou um arquivo de cabeçalho que a Ciarem não tem guardado não podem ser enviados pelo HubSpot. |
| **Este portal não está mais conectado à Ciarem.** | Conecte o HubSpot de novo na Ciarem, em **Configurações > Integrações > HubSpot**. |
| **Este contato ainda não foi sincronizado com a Ciarem.** | Confira se seus [filtros de importação](https://help.ciarem.ai/pt/integrations/hubspot.md#o-que-sincroniza) incluem o contato. Se o workflow começa assim que um contato é criado, adicione uma espera curta antes da ação da Ciarem para que o contato tenha tempo de sincronizar. Inscreva o contato de novo quando ele já estiver sincronizado. |
| **Outro contato do HubSpot tem o mesmo número de telefone, e-mail ou usuário do Instagram** | Mescle os dois contatos no HubSpot ou corrija um deles. O ID do registro do outro contato está nos detalhes da etapa. Veja [Contatos não importados](https://help.ciarem.ai/pt/integrations/hubspot.md#contatos-não-importados). |
| **Este contato não tem um número de telefone acessível pelo WhatsApp.** | Adicione o número de WhatsApp do contato no HubSpot, com o código do país, por exemplo +55. |
| **O modelo selecionado não está mais aprovado ou não existe mais.** | Abra a ação e escolha outro modelo. |
| **Uma variável do modelo está sem valor** | Dê um valor a cada variável em **Valores das variáveis (JSON)**, e confira se o contato tem todas as propriedades que o modelo usa. |
| **A carteira de WhatsApp da Ciarem não tem saldo suficiente.** | Recarregue sua carteira de WhatsApp na Ciarem. Veja [Planos e faturamento](https://help.ciarem.ai/pt/billing/plans-and-billing.md). |
| **Esta conta do WhatsApp atingiu o número de novas conversas que a Meta permite iniciar em 24 horas.** | Espere a janela de 24 horas liberar e inscreva de novo os contatos que não receberam. |
| **O contato se descadastrou do marketing por WhatsApp** | Não há nada a corrigir: o contato pediu para não receber mensagens de marketing. Veja [Descadastro de marketing por WhatsApp](https://help.ciarem.ai/pt/channels/whatsapp-marketing-opt-out.md). |
| **Este registro tem mais de 25 contatos associados.** | Use um workflow baseado em contatos para alcançar todos. |
| **Este registro não tem contatos associados para enviar.** | Associe os contatos à empresa ou ao negócio no HubSpot. |
| **A Ciarem não tem permissão para ler os contatos deste registro.** | Na Ciarem, abra **Configurações > Integrações > HubSpot** e clique em **Conceder acesso** no aviso. |
| **O WhatsApp rejeitou a mensagem.** | Os detalhes da etapa trazem o motivo do WhatsApp. Se continuar acontecendo, [relate um problema](https://help.ciarem.ai/pt/getting-started/report-a-problem.md). |


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