Como as integrações funcionam?
Conecte sua loja, canais de mensagens e ferramentas de trabalho à Agenola para que seus agentes possam trabalhar com eles.
Para que servem as integrações
Uma integração conecta a Agenola a outro sistema que você usa. Depois de conectar, o agente pode ler um produto da sua loja no momento em que perguntam, solicitações abertas no chat podem chegar à sua central de ajuda, sua equipe pode ser avisada no Slack ou uma etapa do fluxo pode adicionar uma linha ao Google Sheets.
Dados da loja (produtos, preços, estoque) não são copiados para a Agenola; são lidos do fornecedor quando um visitante pergunta.
Onde encontrar a página Integrações
Abra “Integrações” no menu à esquerda. Há duas abas no topo: “Catálogo” e “Estatísticas de ações”.
- Use o menu à esquerda para escolher “Todas”, “Conectada” ou uma categoria: E-commerce, Mensagens, Suporte, Apps de trabalho, Análise…
- Digite um nome de marca ou uma tarefa (“calendário”, “suporte”) na caixa “Buscar integrações…”, no canto superior direito.
- O selo em cada card mostra o estado: “Conectada”, “Disponível”, “Em breve” ou “Precisa de atenção”. Fornecedores marcados como “Em breve” ainda não estão disponíveis e não podem ser abertos.
Clique em um card para abrir a página do fornecedor. A seção “O que ele faz”, no fim, lista o que a Agenola realmente faz com esse fornecedor, em “Leituras”, “Ações” e “Gatilhos”.
Duas formas de conectar: um clique ou um formulário
- Conexão com um clique (OAuth): você pressiona o botão do fornecedor, aprova na tela de consentimento dele e volta para a Agenola. Você não copia nenhuma chave ou token. Shopify, WooCommerce, Magento, Zendesk, Gorgias, Intercom, Slack, Microsoft Teams, Trello, Jira, Meta Pixel, TikTok e os apps do Google se conectam assim.
- Conexão por formulário: você informa uma chave ou credencial do painel do fornecedor. WhatsApp e Freshdesk se conectam assim. A maioria dos formulários testa os dados antes de salvar.
No Telegram, o bot é adicionado de dentro do Telegram.
As chaves informadas ficam guardadas com criptografia e nunca mais são mostradas. Para mudar uma, informe um novo valor e pressione “Atualizar dados” (ou “Atualizar chave”).
Quem pode conectar
Conectar, atualizar e remover uma conexão exige permissão de gerenciamento: só o proprietário e os administradores podem fazer isso. Usuários de Suporte e Observador veem as páginas dos fornecedores, mas não os botões de conexão; a página diz “Apenas o proprietário e os administradores do espaço de trabalho podem alterar esta conexão.”
As conexões pertencem ao espaço de trabalho: depois de conectada, todo agente do espaço pode usá-la.
Onde uma conexão é usada
- Como etapa do fluxo: no editor, em “Adicionar etapa” → “Integrações”, cada fornecedor tem seu card. A etapa “Ação de integração” é invisível para os visitantes; ela faz a tarefa escolhida e segue pela saída “Ao concluir” ou “Se falhar”.
- Na etapa Assistente de IA: na aba “Integrações” da etapa, você ativa uma integração e escolhe quais ações o agente pode usar; ele as chama sozinho durante a conversa.
- Para notificações: você escolhe qual notificação vai para Slack, Microsoft Teams ou Telegram em Conta → “Alertas e notificações”.
- Para medição: Google Analytics, Meta Pixel, TikTok e Google Ads são ativados na aba “Configurações de medição” de cada agente.
- Para solicitações: se uma central de ajuda estiver conectada, as solicitações abertas no chat também são encaminhadas a ela.
Limites, remoção e reconexão
- Uma central de ajuda (Zendesk, Gorgias, Intercom ou Freshdesk) pode ser conectada por espaço de trabalho. WooCommerce e Magento também conectam uma loja por espaço.
- Para evitar abusos, as etapas do fluxo e o agente juntos podem fazer no máximo 20 exclusões/cancelamentos e 100 envios pelas suas contas (como mensagens do WhatsApp e e-mails) por espaço de trabalho por hora.
- Para desconectar, pressione “Desconectar” (ou “Remover conexão”) na página do fornecedor e confirme. As etapas do fluxo que usam esse fornecedor passam a seguir pela saída “Se falhar”.
- Se a página pedir para reconectar, a permissão pode ter sido revogada ou expirado. Remova a conexão e conecte de novo com as mesmas etapas.
Artigos relacionados
- Como conectar minha loja Shopify?Instale a Agenola pela Shopify App Store e conecte sua conta com um clique no painel da Shopify. O agente lê seus produtos ao vivo da Shopify a cada pergunta.
- Como conectar minha loja WooCommerce?Instale o plugin da Agenola no WordPress e conecte sua loja; o agente passa a ler os produtos da sua loja.
- Como configurar as etapas Ação de integração e Chamada de ferramenta?Faça um trabalho em uma integração conectada ou chame sua própria ferramenta em um ponto do agente: saídas, ramo de falha e novas tentativas.
- Onde posso monitorar a saúde das ações de integração?A página “Estatísticas de ações” mostra cada tarefa que suas etapas de fluxo e o agente executam nas integrações, as falhas e os motivos.
- Convidar membros da equipe e entender as funçõesAdicionar um colega com um link de convite, convites pendentes, mudar funções, remover membros e o que cada função pode fazer.