> For the complete documentation index, see [llms.txt](https://help.ticto.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.ticto.com.br/sou-produtor/tictools-integracoes/outros/manychat.md).

# Manychat

## Índice

* [Visão Geral Manychat](#visao-geral-manychat)
* [Antes de começar — Requisitos e limitações](#antes-de-comecar-requisitos-e-limitacoes)
* [Parte 1 — Configurando o ManyChat](#parte-1-configurando-o-manychat)
* [Parte 2 — Criando a integração na Ticto](#parte-2-criando-a-integracao-na-ticto)
* [Parte 3 — Criando as segmentações](#parte-3-criando-as-segmentacoes)
* [Como enviar a identificação do usuário para o checkout](#como-enviar-a-identificacao-do-usuario-para-o-checkout)
* [Video passo a passo](#quer-ver-na-pratica)

***

### Visão Geral Manychat

O ManyChat é uma plataforma de automação de conversas que permite criar chatbots interativos para Facebook Messenger, WhatsApp e Instagram. A integração com a Ticto permite atualizar os dados dos seus leads no ManyChat com as informações coletadas durante o checkout — possibilitando funis de recuperação de vendas de forma automática.

**Exemplo prático:** um lead interage com seu bot no Instagram e recebe um link de oferta. Ele acessa o checkout, preenche os dados, mas abandona sem concluir. Com a integração ativa, os dados preenchidos na Ticto são enviados automaticamente ao ManyChat, permitindo que você dispare uma mensagem pelo direct com um desconto para recuperar a venda.

***

### ⚠️ Antes de começar — Requisitos e limitações

{% hint style="danger" %}
**A integração com o ManyChat permite apenas a atualização de leads existentes.** A Ticto **não** realiza o cadastro de novos leads na sua conta do ManyChat.
{% endhint %}

{% hint style="warning" %}
**Limitação da Meta (Facebook, Instagram e WhatsApp):** O envio de mensagens é permitido apenas dentro de uma janela de **24 horas** após a última interação do contato. Fora desse prazo, o envio é limitado e pode gerar custos adicionais por mensagem.
{% endhint %}

**Requisitos obrigatórios antes de começar:**

| Requisito                   | Detalhe                                                       |
| --------------------------- | ------------------------------------------------------------- |
| **Conta PRO no ManyChat**   | A integração não funciona em contas gratuitas                 |
| **Produto criado na Ticto** | A integração é configurada a nível de produto                 |
| **Desbloqueio via chamado** | Toda nova integração deve ser solicitada antes de ser ativada |

**Status de pagamento disponíveis nesta integração:**

* Boleto gerado
* Carrinho abandonado
* Cartão recusado

***

### 📱 Parte 1 — Configurando o ManyChat

Antes de acessar a Ticto, você precisará criar uma tag e copiar a API Key dentro do ManyChat.

{% stepper %}
{% step %}

### Crie uma tag no ManyChat

Acesse sua conta no ManyChat.

No menu, vá até **Configurações → Automações → Tags**.

Crie uma nova tag com o nome do evento que deseja segmentar.

{% hint style="info" %}
Exemplo de nome: `BOLETO GERADO`, `CARRINHO ABANDONADO`, `CARTÃO RECUSADO`
{% endhint %}
{% endstep %}

{% step %}

### Copie a API Key

Ainda no ManyChat, acesse **Configurações → Extensões → Interface de Programação de Aplicativos**.

Copie a **API Key** exibida — você usará essa chave na Ticto.
{% endstep %}
{% endstepper %}

***

### 🔗 Parte 2 — Criando a integração na Ticto

{% stepper %}
{% step %}
Faça login na sua conta da Ticto e no menu lateral, clique em **TICTOOLS**.

<div data-with-frame="true"><figure><img src="/files/TGpMcjJts8lxRg0tNi9C" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Outros.**

<div data-with-frame="true"><figure><img src="/files/lAjxgQpboUy0jOhQTIGd" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **ManyChat.**

<div data-with-frame="true"><figure><img src="/files/nd7wW8oJSxppHispY80R" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Clique em **Nova Integração.**

<div data-with-frame="true"><figure><img src="/files/TdexZnJ1dsGpV80WOCJs" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
Preencha os campos do formulário:

| Campo             | O que preencher                                      |
| ----------------- | ---------------------------------------------------- |
| **Produto**       | Selecione o produto que deseja vincular à integração |
| **Nome da Conta** | Dê um nome para identificar esta integração          |
| **API Key**       | Cole a chave copiada do ManyChat no Passo 2          |

<div data-with-frame="true"><figure><img src="/files/abkRsPjv2wImgv7g6VcS" alt=""><figcaption></figcaption></figure></div>

Clique em **Salvar** ✅
{% endstep %}

{% step %}
**Teste a conexão**

Antes de criar as segmentações, verifique se a integração foi configurada corretamente:

1. Na lista de integrações, localize a que você acabou de criar
2. Clique em **Ações → Testar Conexão**

{% hint style="success" %}
Se tudo estiver correto, uma **mensagem de sucesso** será exibida. Só prossiga para as segmentações após confirmar que a conexão está ativa.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🎯 Parte 3 — Criando as segmentações

As segmentações definem **qual ação será disparada no ManyChat** quando um lead realizar determinado evento no checkout da Ticto.

{% stepper %}
{% step %}
Na lista de integrações, clique nos **3 pontos** da integração desejada. Clique em **Segmentações**.

<div data-with-frame="true"><figure><img src="/files/dE04gHM12797qV7CTRFR" alt=""><figcaption></figcaption></figure></div>

Clique em **+ Adicionar nova segmentação** ou **+ Cadastrar novo**.

<div data-with-frame="true"><figure><img src="/files/xEfRSbPawi9pBRsY4WbO" alt=""><figcaption></figcaption></figure></div>
{% endstep %}

{% step %}
**Configure a segmentação.** Preencha os **campos** conforme o **evento** que deseja monitorar:

| Campo                                   | O que preencher                              | Exemplo                   |
| --------------------------------------- | -------------------------------------------- | ------------------------- |
| **Título da Segmentação**               | Nome para identificar a segmentação          | `BOLETO`                  |
| **Quando o seu lead — Executar a ação** | Selecione a ação que dispara a segmentação   | `Comprar`                 |
| **Ofertas**                             | Selecione a oferta que ativará a segmentação | Sua oferta desejada       |
| **Do Tipo**                             | Selecione o status de pagamento              | `Boleto emitido`          |
| **Execute a ação**                      | Tipo de ação a executar no ManyChat          | `Adicionar contato e tag` |
| **Tags**                                | Selecione a tag criada no ManyChat           | `BOLETO GERADO`           |

<div data-with-frame="true"><figure><img src="/files/sG91hoUnL4xb4Zr2vYq5" alt=""><figcaption></figcaption></figure></div>

\
Clique em **Salvar** ✅

{% hint style="info" %}
Repita o processo para cada status de pagamento que deseja monitorar — Boleto gerado, Carrinho abandonado, Cartão recusado.
{% endhint %}
{% endstep %}

{% step %}
**Teste a Segmentação.**&#x20;

Após criar a segmentação, teste para confirmar que está funcionando:

1. No menu **Segmentações**, localize a segmentação criada
2. Clique em **Testar**

{% hint style="success" %}
Se estiver tudo certo, uma **mensagem de confirmação** será exibida. ✅
{% endhint %}
{% endstep %}
{% endstepper %}

***

### 🔗 Como enviar a identificação do usuário para o checkout

{% hint style="danger" %}
**Este passo é obrigatório para que a integração funcione.** Toda vez que enviar um lead para o checkout da Ticto via ManyChat, você precisa incluir a identificação única do usuário na URL.
{% endhint %}

### Formato da URL

Adicione o parâmetro `manychatUserID` ao link do checkout:

```
https://checkout.ticto.com.br/IDdaMinhaOferta?manychatUserID=XXXXXXX
```

Substitua `XXXXXXX` pelo valor dinâmico da identificação do usuário no ManyChat.

### Como inserir isso no ManyChat

Ao criar uma mensagem no ManyChat com um link, use o valor dinâmico disponível nos **parâmetros do usuário** do ManyChat para compor a URL automaticamente:

```
https://checkout.ticto.com.br/IDdaMinhaOferta?manychatUserID={{user_id}}
```

{% hint style="info" %}
O campo `{{user_id}}` é preenchido automaticamente pelo **ManyChat** com a identificação de cada usuário no momento do envio da mensagem.
{% endhint %}

***

### 🎥 Quer ver na prática?

Assista ao vídeo completo com o passo a passo em funcionamento:

{% embed url="<https://www.youtube.com/watch?v=JRkLD2eKCtQ>" %}

***