> For the complete documentation index, see [llms.txt](https://alcavie-systems-1.gitbook.io/suporte/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://alcavie-systems-1.gitbook.io/suporte/integracoes/botconversa.md).

# Botconversa

***

## Como funciona

A integração entre o **Alcavie** e o **BotConversa** permite:

* **Criar automaticamente clientes no BotConversa**, sempre que forem cadastrados no Alcavie com telefone preenchido.
* **Sincronizar etiquetas** entre o Alcavie e o BotConversa para facilitar segmentações e campanhas.
* **Vincular etiquetas automaticamente** com base em condições específicas, como mês de aniversário ou tipo de venda (Carnê e Cashback).

> Para o correto funcionamento da integração de etiquetas, algumas delas precisam ser criadas previamente no BotConversa (detalhes abaixo).

## Como integrar com o Alcavie

**1. Obter chave API do BotConversa**

Acesse sua conta no BotConversa e vá até o menu lateral em **Configurações → Integrações → API**. Nessa tela, copie a sua **Chave API**, que será utilizada no Alcavie.

<figure><img src="/files/zyrD3FWKuv27IYqsRyg2" alt=""><figcaption></figcaption></figure>

**2. Inserir chave no Alcavie**

No painel do Alcavie, acesse o menu **Minha loja** e clique na seção **Integrações**. Cole a chave copiada no campo “Chave API BotConversa”, ative a opção **"Criar novos clientes Alcavie também no BotConversa"** e clique em salvar para finalizar essa etapa.

<figure><img src="/files/4iIbNRgz9ujHwLTTmx6G" alt=""><figcaption></figcaption></figure>

**3. Criar etiquetas no BotConversa**

Antes de sincronizar, é necessário criar manualmente as etiquetas que serão utilizadas na integração. Para isso, vá até **Configurações → Etiquetas** e clique no botão azul no canto superior direito da tela chamado **"Criar nova etiqueta"**. Digite o nome da etiqueta desejada (ex: “Carnê” “Cashback”, “Janeiro”, etc.) e confirme a criação.

<figure><img src="/files/SePrgzojhDSE7R7cdehe" alt=""><figcaption></figcaption></figure>

> ✳️ As etiquetas obrigatórias para integração são:\
> **Carnê, Cashback, Janeiro, Fevereiro, Março, Abril, Maio, Junho, Julho, Agosto, Setembro, Outubro, Novembro, Dezembro**

**4. Sincronizar etiquetas**

Após salvar, um novo botão chamado **"Sincronizar etiquetas BotConversa"** será exibido. Clique nele para importar as etiquetas já cadastradas no BotConversa para o Alcavie.

{% hint style="warning" %}
⚠️ Antes de sincronizar, é necessário que você crie manualmente as seguintes etiquetas dentro da sua conta do BotConversa, pois o sistema deles não permite a criação via API:\
**Carnê, Cashback, Janeiro, Fevereiro, Março, Abril, Maio, Junho, Julho, Agosto, Setembro, Outubro, Novembro, Dezembro**
{% endhint %}

<figure><img src="/files/0PNXv30lk41T3E0abCd6" alt=""><figcaption></figcaption></figure>

**5. Criação automática de clientes**

Sempre que um novo cliente for cadastrado no Alcavie com o campo **telefone/celular** preenchido, ele também será criado automaticamente no BotConversa. Caso o campo **data de nascimento** seja informado, o sistema adicionará a **etiqueta correspondente ao mês de aniversário**.

**6. Etiquetas por tipo de venda**

Sempre que uma venda for registrada com as opções **Carnê** ou **Cashback** selecionadas, essas etiquetas serão automaticamente vinculadas ao cliente no BotConversa, permitindo um controle mais eficiente e segmentações futuras.

## Finalizando

Pronto! Agora você está com a integração entre o **Alcavie** e o **BotConversa** configurada corretamente. A partir deste momento, os clientes cadastrados no sistema com telefone serão automaticamente enviados para o BotConversa, com as etiquetas aplicadas conforme suas informações e tipos de venda.

Com essa automação, você ganha agilidade no cadastro, melhora a segmentação do público e fortalece suas ações de marketing e relacionamento com os clientes.

Se tiver qualquer dúvida ou encontrar dificuldades durante o processo, nossa equipe de [suporte ](/suporte/introducao-ao-alcavie/suporte.md)está à disposição para te ajudar. 😉

{% hint style="info" %}
💡Para mais informações sobre o funcionamento do BotConversa, acesse a [Central de Ajuda oficial](https://ajuda.botconversa.com.br/pt-br).
{% endhint %}