# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://alcavie-systems-1.gitbook.io/suporte/integracoes/botconversa.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.