--- title: "Conectando com outras ferramentas (Integrador)" url: https://ajuda.botconversa.com.br/aula/conectando-com-outras-ferramentas-integrador section: "Criando automações" date_modified: 2026-09-06T18:35:20.325155+00:00 language: pt-BR --- # Conectando com outras ferramentas (Integrador) [Vídeo da aula](https://www.youtube.com/watch?v=TjJt8_IUFQU) **Tempo de leitura:** ~6 min**Para quem é:** Gestor | Marketing | Dono do negócio ## Resposta rápida O **Integrador** é a ponte entre o BotConversa e outros aplicativos (como Google Calendar, Google Sheets e CRMs). Cada **automação** liga um app que envia os dados (o "De") a um app que recebe os dados (o "Em"). Vá em **Integrador → Automações → + Nova automação**, escolha o app e o evento de origem, depois o app e a ação de destino. Teste e ative. ## 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. ## Casos de uso **Consultório:** quando o paciente confirma um horário no fluxo, o Evento do Integrador cria o compromisso no Google Calendar da clínica, sem ninguém digitar nada. **Equipe de vendas:** cada lead que termina o fluxo de qualificação vira uma nova linha numa planilha do Google Sheets, organizada com nome, telefone e interesse. ## Perguntas frequentes Qual a diferença entre o Integrador e os Webhooks da Automação? O webhook de entrada é uma forma simples de receber dados de fora e criar contatos. O Integrador é mais amplo: conecta vários apps, em ambos os sentidos, com gatilhos e ações. Veja [Configurando webhooks](/aula/configurando-webhooks). Como meu fluxo dispara uma automação do Integrador? Pelo **Evento do Integrador**: um bloco de Integração no fluxo marca o ponto de disparo, e a automação reage a ele. Veja Entendendo os tipos de bloco. O que é a cota de ações? É o limite de execuções da sua conta. Cada automação que roda consome uma ação. Acompanhe o consumo no topo da tela do Integrador. Onde vejo se uma automação deu certo? Na aba **Histórico**, que lista cada execução com resultado e status, e permite reenviar as que falharam.