Conectando com outras ferramentas (Integrador)

Explicação

O que é o Integrador

O Integrador funciona como um conector entre programas. Ele permite que o BotConversa converse com ferramentas que você já usa, sem ninguém precisar copiar dados de um lugar para outro.

Cada conexão é uma automação, montada na lógica De → Em:

• De (origem / gatilho) — o app que envia os dados e dá o "start". É o que inicia a automação.
• Em (destino / ação) — o app que recebe os dados e executa algo em resposta.

Exemplos de apps que entram nessa ponte: BotConversa, Google Calendar, Google Meet, Google Sheets (planilhas), além de CRMs e ferramentas de marketing.

Como o seu fluxo aciona o Integrador

Uma forma comum de usar é fazer o seu fluxo disparar uma automação. Para isso, existe o Evento do Integrador: dentro de um fluxo, um bloco de Integração marca o ponto que dispara o evento. A automação do Integrador "escuta" esse evento e, quando ele acontece, executa a ação no app de destino.

Na prática: o cliente percorre o fluxo, chega ao bloco de Integração, e isso aciona, por exemplo, a criação de uma linha numa planilha ou de um evento na agenda.

A cota de ações e as transações

Cada vez que uma automação roda, conta como uma transação. A conta tem uma cota de ações (um teto de execuções por período). Você acompanha tudo na aba Histórico, que lista cada transação com seu resultado e permite reprocessar as que falharam.

Como criar uma automação (visão geral)

Passo 1: Abra o Integrador e crie uma automação

No menu lateral, clique em Integrador e fique na aba Automações. Clique no card + Nova automação. O editor abre com dois espaços: um para o app de origem e outro para o app de destino.

Passo 2: Escolha o gatilho (o "De")

Em Selecione um App para enviar os dados, escolha o app de origem e o evento que vai iniciar a automação. Se o disparo vier de um fluxo seu, use o Evento do Integrador (do BotConversa).

Passo 3: Escolha a ação (o "Em")

Em Selecione um App para receber os dados, escolha o app de destino e a operação que ele deve executar (ex.: criar um evento no Google Calendar, gravar uma linha no Google Sheets). Aponte quais dados recebidos preenchem cada campo da ação.

Ações comuns do BotConversa como destino

Quando o destino é o próprio BotConversa, as ações mais usadas são:

• Alterar Data e Hora — atualiza um campo personalizado de Data ou Data e Hora no Cartão do Usuário (ex.: marcar proximo_agendamento no momento em que o cliente confirma um horário no Google Calendar). Útil para lembretes e relançamento.
• Enviar Fluxo de Mensagens — coloca o contato em um fluxo específico. Se o contato ainda não existir, ele é criado a partir dos dados recebidos do app de origem antes do fluxo rodar.
• Adicionar/Remover Etiqueta — marca o contato (ex.: etiqueta comprou quando o pagamento confirma no app de e-commerce).
• Adicionar/Remover Sequência — inscreve ou retira o contato de uma sequência.
• Definir Campo Personalizado — grava qualquer valor recebido em um campo.

Cada ação aceita mapear o telefone (chave do contato) e os demais campos vindos do "De".

Passo 4: Teste e ative

Use Teste para validar e Executar para rodar. Acompanhe os resultados pela aba Histórico.

Atenção: conectar um app costuma exigir autorizar o acesso (login na ferramenta externa). Isso é feito na aba Apps, que guarda as credenciais. Faça essa autorização com a sua própria conta do serviço.

Quando usar

• Quando você quer registrar leads numa planilha ou num CRM automaticamente.
• Quando quer criar eventos na agenda a partir de um agendamento feito no chat.
• Quando quer conectar o BotConversa a ferramentas de marketing e vendas que já usa.
• Quando precisa de algo mais amplo que um webhook simples, envolvendo vários aplicativos.