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

# Migrar Automações de SMS para WhatsApp

> Leve seus fluxos de trabalho do gatilho e das ações nativas de SMS do HighLevel para os gatilhos e ações próprios do provedor personalizado WhatsApp QR.

Se você conectou o WhatsApp pelo método legado, ele **sobrescreve o SMS nativo da sua subconta**. Seus fluxos de trabalho continuam dizendo **Enviar SMS** e **Cliente Respondeu**, mas as mensagens saem pelo WhatsApp.

Funciona. Só que esconde o WhatsApp atrás do SMS: sem anexos, sem roteamento por número, sem filtros do WhatsApp e sem esperas que reagem às respostas.

O **provedor personalizado WhatsApp QR** adiciona seus próprios gatilhos e ações ao construtor de fluxos de trabalho, para que suas automações rodem no WhatsApp de forma intencional, e não por herança. Este guia faz a troca, um fluxo de trabalho por vez.

|                              | **Método legado (sobrescrita do SMS nativo)**        | **Provedor personalizado WhatsApp QR**                                          |
| ---------------------------- | ---------------------------------------------------- | ------------------------------------------------------------------------------- |
| **Como o WhatsApp funciona** | Sobrescreve o SMS nativo da subconta                 | Como seu próprio canal, vinculado por leitura de QR                             |
| **Com o que você constrói**  | O gatilho e as ações **nativas** de SMS do HighLevel | Os gatilhos e ações próprios do provedor de WhatsApp                            |
| **Onde ficam**               | Nas listas padrão de gatilhos e ações                | Na aba **Apps**                                                                 |
| **O que você obtém**         | Apenas texto simples: WhatsApp tratado como SMS      | Anexos, envio por número, filtros do WhatsApp e esperas que reagem às respostas |

<Note>
  Esta página cobre **apenas a parte dos fluxos de trabalho**. Para a conexão em si, consulte [Configuração do WhatsApp](/pt-BR/whatsapp/full-setup) e [Configuração Legada do WhatsApp](/pt-BR/whatsapp/sms-provider-setup).
</Note>

<Info>
  Nada quebra se você não fizer nada. Enquanto a sobrescrita do SMS nativo estiver ativa, a ação nativa **Enviar SMS** continua entregando pelo WhatsApp. Migrar é sobre ganhar os recursos reais do WhatsApp, não sobre consertar uma configuração quebrada.
</Info>

***

## Você precisa deste guia?[​](#você-precisa-deste-guia "Link direto para Você precisa deste guia?")

Você precisa se algum fluxo de trabalho publicado usa um destes itens **e você espera que ele alcance as pessoas pelo WhatsApp**:

* Ação **Enviar SMS**
* Gatilho **Cliente Respondeu** com o Canal de Resposta definido como SMS
* Ação **Notificação Interna** por SMS ou WhatsApp
* Ação **Espera** definida como *o contato responder* por SMS

***

## Antes de Começar[​](#antes-de-começar "Link direto para Antes de Começar")

<Steps>
  <Step title="Atualize o app do provedor de WhatsApp">
    **Marketplace de Apps → Apps Instalados → WhatsApp provider → Atualizar**
  </Step>

  <Step title="Conecte um número de WhatsApp">
    Use o **painel de Configurações do WhatsApp** para conectar uma ou mais instâncias
  </Step>
</Steps>

<Warning>
  Até que os dois passos estejam concluídos, os gatilhos e ações do WhatsApp não aparecerão na aba **Apps**. Se você não os encontrar, está na aba errada ou o app precisa ser atualizado.
</Warning>

***

## O Que Substitui o Quê[​](#o-que-substitui-o-quê "Link direto para O Que Substitui o Quê")

| Hoje (nativo)                                  | Troque por                                                                                                         |
| ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| **Cliente Respondeu**, Canal de Resposta = SMS | Gatilho [**WhatsApp de Entrada**](/pt-BR/automation/triggers/whatsapp-inbound)                                     |
| *Nada: o gatilho sempre tinha um contato*      | Ação **Buscar Contato** ou **Criar Contato**                                                                       |
| **Enviar SMS**                                 | Ação [**Enviar Mensagem de WhatsApp**](/pt-BR/automation/actions/send-whatsapp-message)                            |
| **Notificação Interna**, SMS ou WhatsApp       | Ação [**Enviar Notificação Interna de WhatsApp**](/pt-BR/automation/actions/internal-notification-action-whatsapp) |
| **Espera**, *o contato responder* por SMS      | [**Etapa de Espera**](/pt-BR/automation/actions/wait-step), Canal = WhatsApp                                       |

Toda substituição do WhatsApp fica na aba **Apps** → app **WhatsApp provider**, nunca nas listas padrão. **Buscar Contato** e **Criar Contato** são ações nativas do HighLevel, já disponíveis em todos os fluxos de trabalho.

***

## Como Migrar um Fluxo de Trabalho[​](#como-migrar-um-fluxo-de-trabalho "Link direto para Como Migrar um Fluxo de Trabalho")

Trabalhe um fluxo de trabalho por vez.

<Steps>
  <Step title="Duplique, não edite o original">
    Copie o fluxo de trabalho e renomeie a cópia, por exemplo "Follow-Up de Leads - WhatsApp". O original permanece publicado e intacto enquanto você constrói.
  </Step>

  <Step title="Troque o gatilho e depois resolva o contato">
    Substitua **Cliente Respondeu** por **WhatsApp de Entrada** e adicione **Buscar Contato** ou **Criar Contato** logo abaixo. Tudo o que vem depois depende da existência do contato.
  </Step>

  <Step title="Troque as ações">
    Use a tabela acima. Reinsira as variáveis com o ícone de etiqueta em vez de colá-las, para que fiquem vinculadas ao campo correto.
  </Step>

  <Step title="Leve os filtros descartados para dentro do fluxo de trabalho">
    Verificações de etiquetas, Tipo de Intenção e Respondeu ao Fluxo de Trabalho viram condições **If/Else** depois da etapa do contato.
  </Step>

  <Step title="Publique a cópia e teste com você mesmo">
    Envie uma mensagem para o seu número conectado a partir do seu próprio telefone e percorra todo o caminho: a resposta chega, o contato é resolvido, a mensagem é enviada e o alerta interno chega.
  </Step>

  <Step title="Aposente o original">
    Somente depois que o novo estiver confirmado, volte o fluxo de trabalho antigo para **Rascunho**. Os contatos que já estão nele terminam normalmente.
  </Step>
</Steps>

<Warning>
  Nunca deixe a versão antiga e a nova do mesmo fluxo de trabalho publicadas ao mesmo tempo: cada contato receberia duas mensagens.
</Warning>

***

## 1. Cliente Respondeu → WhatsApp de Entrada[​](#1-cliente-respondeu--whatsapp-de-entrada "Link direto para 1. Cliente Respondeu → WhatsApp de Entrada")

|                    | **Cliente Respondeu**                                                                                                                             | **WhatsApp de Entrada**                                                                                                                                   |
| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Dispara quando** | Um contato responde a uma mensagem                                                                                                                | Uma mensagem chega em um número de WhatsApp conectado, incluindo uma primeira mensagem de um número desconhecido                                          |
| **Canais**         | Email, SMS, WhatsApp, Redes sociais, All-in-One Chat                                                                                              | Apenas WhatsApp                                                                                                                                           |
| **Filtros**        | Contém Frase, Correspondência Exata de Frase, Tem Etiqueta, Não Tem Etiqueta, Tipo de Intenção, Respondeu ao Fluxo de Trabalho, Canal de Resposta | Contact ID, Lid, Location ID, Mensagem, Nome do Destinatário, Número do Destinatário, Nome do Remetente, Número do Remetente, Nome de Usuário do WhatsApp |
| **Contato**        | Sempre um contato conhecido                                                                                                                       | Você mesmo resolve: veja a [etapa 2](#2-resolva-o-contato-buscar-contato-ou-criar-contato)                                                                |

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/automation/triggers/assets/images/whatsapp-inbound-trigger-66aff58a089ff2dd9d05eeb85bf3f43d.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=7cb831688bac3040422ab6ec73691db8" alt="Gatilho WhatsApp de Entrada" width="2860" height="1522" data-path="images/automation/triggers/assets/images/whatsapp-inbound-trigger-66aff58a089ff2dd9d05eeb85bf3f43d.png" />
</Frame>

**O que você ganha**: filtrar por *Número do Destinatário* permite rodar um fluxo de trabalho diferente para cada número conectado, e o filtro *Mensagem contém* cobre o mesmo roteamento por palavra-chave que você fazia com **Contém Frase**.

| Antes                                                               | Depois                                                                        |
| ------------------------------------------------------------------- | ----------------------------------------------------------------------------- |
| Cliente Respondeu, Canal de Resposta = SMS, Contém Frase = "preços" | WhatsApp de Entrada, Mensagem *contém* "preços" → Buscar Contato → suas ações |

***

## 2. Resolva o Contato: Buscar Contato ou Criar Contato[​](#2-resolva-o-contato-buscar-contato-ou-criar-contato "Link direto para 2. Resolva o Contato: Buscar Contato ou Criar Contato")

<Warning>
  Esta etapa não tem equivalente nativo, e pulá-la é o erro número um da migração. O **Cliente Respondeu** sempre entregava um contato conhecido para a etapa seguinte. O **WhatsApp de Entrada** não faz isso: a mensagem pode vir de um número que ainda não está no seu CRM. Adicione esta ação imediatamente após o gatilho.
</Warning>

As duas são ações nativas do HighLevel, então não há nada extra para instalar. Escolha uma:

| Ação               | Mapeie este campo | Para este valor                                                          |
| ------------------ | ----------------- | ------------------------------------------------------------------------ |
| **Buscar Contato** | **ContactID**     | *Whatsapp, imessage and SMS → WhatsApp de Entrada → ContactID*           |
| **Criar Contato**  | **Telefone**      | *Whatsapp, imessage and SMS → WhatsApp de Entrada → Número do Remetente* |

<Steps>
  <Step>
    Clique em **+ Adicionar** abaixo do gatilho
  </Step>

  <Step>
    Busque e selecione **Buscar Contato** ou **Criar Contato**
  </Step>

  <Step>
    Mapeie o campo da tabela acima, inserindo o valor com o ícone de etiqueta
  </Step>

  <Step>
    Clique em **Salvar ação**
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/goghl/CcFj-VvCtpY8rKMa/images/automation/triggers/assets/images/create-contact-action.png?fit=max&auto=format&n=CcFj-VvCtpY8rKMa&q=85&s=a6d2bae82bf99202b5942ab27286b5b8" alt="Ação Criar Contato" width="2940" height="1604" data-path="images/automation/triggers/assets/images/create-contact-action.png" />
</Frame>

**Qual usar?** Use **Criar Contato** quando o remetente puder ser novo no seu CRM: ele pula a criação se o contato já existir, então nunca gera duplicados. Use **Buscar Contato** quando todos os remetentes já forem contatos salvos e você só precisar localizá-los.

Toda ação depois desta (Enviar Mensagem de WhatsApp, Enviar Email, Criar Tarefa) já terá um contato para trabalhar.

***

## 3. Enviar SMS → Enviar Mensagem de WhatsApp[​](#3-enviar-sms--enviar-mensagem-de-whatsapp "Link direto para 3. Enviar SMS → Enviar Mensagem de WhatsApp")

|                     | **Enviar SMS**                                                                                                                                  | **Enviar Mensagem de WhatsApp**                                                                     |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
| **Canal**           | SMS, que chega ao WhatsApp apenas por causa da sobrescrita do SMS nativo                                                                        | WhatsApp, explicitamente                                                                            |
| **Mídia**           | Os anexos são enviados como MMS, sujeitos aos limites de tamanho da operadora, e arquivos grandes demais viram links para a Biblioteca de Mídia | Anexos reais: imagens, vídeo e documentos, enviados do seu sistema ou da Biblioteca de Mídia        |
| **Número de envio** | Não é selecionável                                                                                                                              | Campo opcional **Número de WhatsApp**, ou deixe vazio para usar a ordem de prioridade do seu painel |
| **Formatação**      | Texto simples de SMS                                                                                                                            | Variáveis personalizadas, emojis e quebras de linha aparecem exatamente como você escreve           |

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/automation/actions/assets/images/send-whatsapp-message-action-b67193309e51e35ab0308a71aba2c8f1.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=b4d0da3a075724960617903d66a0a225" alt="Enviar Mensagem de WhatsApp" width="2858" height="1542" data-path="images/automation/actions/assets/images/send-whatsapp-message-action-b67193309e51e35ab0308a71aba2c8f1.png" />
</Frame>

| Antes                                                                          | Depois                                                                                                                                                |
| ------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------- |
| Enviar SMS: "Oi `{{contact.first_name}}`, obrigado! Link: example.com/folheto" | Enviar Mensagem de WhatsApp: "Oi `{{contact.first_name}}`! Obrigado pelo seu interesse, entraremos em contato em breve." com o folheto em PDF anexado |

***

## 4. Notificação Interna → Enviar Notificação Interna de WhatsApp[​](#4-notificação-interna--enviar-notificação-interna-de-whatsapp "Link direto para 4. Notificação Interna → Enviar Notificação Interna de WhatsApp")

|                         | **Notificação Interna**                                    | **Enviar Notificação Interna de WhatsApp**                        |
| ----------------------- | ---------------------------------------------------------- | ----------------------------------------------------------------- |
| **Entrega**             | Escolha um: Email, No App, SMS ou WhatsApp                 | WhatsApp **e** o CRM ao mesmo tempo                               |
| **Destinatários**       | Todos os Usuários, Usuários Específicos, Usuário Atribuído | Usuários Atribuídos, Usuário Específico, **Número Personalizado** |
| **Fora da equipe**      | Não é possível                                             | **Número Personalizado** alcança qualquer número de telefone      |
| **Modelos do WhatsApp** | Precisa usar modelos aprovados                             | Nenhum necessário: escreva a mensagem que quiser                  |

<Frame>
  <img src="https://mintcdn.com/goghl/JZJa2MoUHOf9Nw9w/images/automation/actions/assets/images/whatsapp-internal-notification-action.png?fit=max&auto=format&n=JZJa2MoUHOf9Nw9w&q=85&s=598e0f1004fd9c50dff42cb930d8bab1" alt="Enviar Notificação Interna de WhatsApp" width="3420" height="1804" data-path="images/automation/actions/assets/images/whatsapp-internal-notification-action.png" />
</Frame>

Transfira sua configuração antiga de destinatários para o **Tipo de Usuário de Destino**:

| Antes era                       | Defina Tipo de Usuário de Destino como                                      |
| ------------------------------- | --------------------------------------------------------------------------- |
| Usuário Atribuído               | **Usuários Atribuídos**                                                     |
| Usuários Específicos            | **Usuário Específico**, e depois escolha as pessoas em **Escolher Usuário** |
| Todos os Usuários               | **Usuário Específico**, e selecione todos que precisam                      |
| Um número externo ou de plantão | **Número Personalizado**                                                    |

| Antes                                                                                  | Depois                                                                                                                                              |
| -------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------- |
| Cliente Respondeu → Notificação Interna, SMS, Usuário Atribuído, "O contato respondeu" | WhatsApp de Entrada → Buscar Contato → Enviar Notificação Interna de WhatsApp, Usuários Atribuídos, "`{{contact.first_name}}` acabou de responder." |

***

## 5. Espera → Etapa de Espera[​](#5-espera--etapa-de-espera "Link direto para 5. Espera → Etapa de Espera")

<Warning>
  **Só um tipo de Espera migra.** A ação nativa **Espera** lida com oito tipos de espera. A **Etapa de Espera** substitui exatamente um deles, *o contato responder*, e apenas no seu número conectado de WhatsApp, iMessage ou SMS. Todo o resto continua nativo, e os dois funcionam juntos no mesmo fluxo de trabalho.
</Warning>

| O que você quer                                                                                                | Use                 |
| -------------------------------------------------------------------------------------------------------------- | ------------------- |
| Um atraso fixo, uma data, uma programação recorrente, uma antecedência antes de um agendamento                 | **Espera nativa**   |
| Um clique em link de gatilho, a abertura de um email, uma condição de campo, a resposta de um membro da equipe | **Espera nativa**   |
| Que o *cliente* responda no seu número de WhatsApp conectado                                                   | **Etapa de Espera** |
| Ramificar conforme ele tenha respondido ou não, e usar o que ele disse nas etapas seguintes                    | **Etapa de Espera** |
| Uma resposta a um único número conectado específico                                                            | **Etapa de Espera** |

**O que você ganha**

* **A resposta vem junto.** O texto da mensagem e os anexos são entregues às etapas após **Cliente Respondeu**, então você pode ramificar conforme o que o cliente realmente disse
* **Dois ramos nomeados**: **Cliente Respondeu** e **Tempo Limite**, em vez de um único caminho com uma saída por tempo
* **Escopo por número** com o campo opcional **Número Conectado**

**Usando os dois juntos**

```text theme={null}
Enviar Mensagem de WhatsApp: "Oi {{contact.first_name}}, confirmando amanhã às 15h. Responda SIM para confirmar."
   |
Etapa de Espera - Canal: WhatsApp - Tempo Limite: 1 dia
   |-- Cliente Respondeu -> If/Else sobre o texto da resposta
   |      |-- contém "sim" -> adicionar etiqueta "confirmado"
   |      |-- senão        -> Enviar Notificação Interna de WhatsApp ao usuário atribuído
   |-- Tempo Limite -> Espera nativa (2 horas) -> Enviar Mensagem de WhatsApp: "Você recebeu esta mensagem?"
```

***

## Perguntas Frequentes[​](#perguntas-frequentes "Link direto para Perguntas Frequentes")

<AccordionGroup>
  <Accordion title="Etapas nativas de SMS e do provedor de WhatsApp podem coexistir em um mesmo fluxo de trabalho?">
    Sim, e é a forma recomendada de migrar gradualmente. Também é necessário quando parte do fluxo de trabalho precisa de um recurso exclusivamente nativo, como uma notificação interna por email ou uma Espera com programação recorrente.
  </Accordion>

  <Accordion title="Por que não encontro o gatilho ou a ação do WhatsApp no construtor?">
    Eles só aparecem na aba **Apps**, nunca nas listas padrão. Se a aba Apps não mostrar o app do provedor de WhatsApp, atualize-o em **Marketplace de Apps → Apps Instalados** e conecte pelo menos um número.
  </Accordion>

  <Accordion title="Devo usar Buscar Contato ou Criar Contato?">
    **Criar Contato** quando o remetente puder ser novo no seu CRM: ele pula a criação para contatos existentes, então nenhum duplicado é gerado. **Buscar Contato** quando todos os remetentes já estiverem salvos e você só precisar localizá-los.
  </Accordion>

  <Accordion title="O que acontece com os contatos que já estão em um fluxo de trabalho antigo?">
    Eles terminam o fluxo de trabalho em que estão. Voltá-lo para Rascunho apenas impede a entrada de novos contatos, então deixe os contatos em andamento concluírem antes de excluir qualquer coisa.
  </Accordion>

  <Accordion title="Eu usava os filtros Tem Etiqueta e Tipo de Intenção. E agora?">
    Esses filtros não existem no **WhatsApp de Entrada**. Deixe o gatilho sem filtros ou filtre pelo texto da mensagem, e depois adicione um **If/Else** após a etapa do contato para verificar etiquetas ou qualquer outro campo do contato.
  </Accordion>

  <Accordion title="Preciso migrar minhas etapas de Espera também?">
    Apenas aquelas definidas como *o contato responder* por SMS. Todos os outros tipos de Espera permanecem na ação nativa.
  </Accordion>
</AccordionGroup>

***

## Suporte[​](#suporte "Link direto para Suporte")

Se você precisar de ajuda com a migração:

* Suporte via WhatsApp: [Converse no WhatsApp](https://wa.me/+12267248710?text=Ol%C3%A1%2C%20preciso%20de%20ajuda%20para%20migrar%20minhas%20automa%C3%A7%C3%B5es%20de%20SMS%20para%20o%20WhatsApp.)
* Email: [**support@goghl.ai**](mailto:support@goghl.ai)