Integrações, migração e chaves de API

Em Integrações (/app/integrations), você conecta reactive.chat às ferramentas que sua equipe já usa. As integrações valem para todo o espaço de trabalho. Proprietários e administradores podem configurá-las; um administrador restrito a projetos individuais não pode.

Esta página descreve o que as integrações fazem por você e como usá-las. Os detalhes técnicos, por exemplo sobre a assinatura de webhooks, estão na seção Integração técnica.

Transparência sobre o estado atual

Estão disponíveis conexões com mais de 30 serviços. A maioria foi testada com sistemas simulados, mas ainda não foi executada com o serviço real. A página de integrações as marca com “Não verificada com o serviço real”; algumas mostram “Em andamento”. Webhooks e Slack não têm esse aviso. Configure uma integração não verificada, teste com dados reais e use Enviar feedback para nos avisar se algo não estiver certo.

Configurar uma integração

1. Abra Integrações. No topo, você vê quantas estão conectadas, quantas têm erro ou estão pausadas e se houve falhas nas entregas.
2. Pesquise no catálogo (Pesquisar integrações, filtro “Todas” ou “Não conectadas”) e clique em Configurar.
3. Insira as credenciais pedidas pelo serviço, normalmente uma chave de API ou um token da sua conta nele.
4. Conectar e ativar verifica a conexão imediatamente e ativa a integração. Com Salvar sem ativar, você deixa isso para depois.

Mais tarde, você pode Editar, Pausar, Reativar ou Remover uma integração. A remoção exclui as credenciais armazenadas e não pode ser desfeita. As credenciais são armazenadas de forma criptografada.

Só o Google Drive tem um botão para entrar no serviço. Para todos os outros, você insere as credenciais por conta própria; no Slack, por exemplo, os dados de um aplicativo Slack seu.

Quando um serviço não responde

Cada integração funciona por uma fila. Se um serviço não responder, a entrega é tentada novamente várias vezes, com intervalos crescentes; após falhas repetidas, fica suspensa por algum tempo (“Temporariamente suspensa: o serviço deixou de responder repetidamente …”). Um evento que não foi entregue após cerca de uma hora é descartado. Você vê as entregas com falha mais recentes na seção Entregas com falha, sem o conteúdo delas.

Uma mensagem de chat nunca espera por uma integração. Se um serviço travar, o chat continua funcionando normalmente.

O que está disponível

Notificações para sua equipe

• Slack — cada nova conversa aparece como um tópico em um canal. Você responde no tópico, e o visitante vê a resposta no chat. /rc mostra o estado. Você associa usuários do Slack a atendentes.
• Microsoft Teams, Discord — notificações por um endereço de webhook.
• Telegram — notificações para um chat por token de bot e ID do chat.
• E-mail — notificações para uma caixa de e-mail da equipe.

Automação

• Webhooks — reactive.chat envia eventos assinados para um endereço https:// à sua escolha: nova conversa, cada mensagem, solicitação de transferência para uma pessoa, avaliação recebida, novo caso de erro. Zapier, Make e n8n também se conectam assim. Você pode revelar, copiar e gerar novamente o Segredo de assinatura; um novo segredo vale imediatamente, e o antigo deixa de valer.
• Zapier — pelos hooks REST da interface. Ainda não há um aplicativo pronto para Make e n8n; use webhooks neles.

Contexto no painel de atendimento

Estas integrações mostram cards sobre o visitante na coluna de contexto do painel, por exemplo seus pedidos ou contato no CRM, alguns com ações:

• CRM — HubSpot, Pipedrive
• Loja — Shopify, Shopware 6, WooCommerce
• Pagamentos — Stripe (com uma chave de leitura restrita)
• Site — WordPress
• Análise — Matomo, Plausible, Google Analytics 4
• Erros — Sentry

O card identifica detalhes baseados em uma declaração não assinada do visitante. Você realiza ações com Executar e uma confirmação.

Tickets, agendamentos, telefone

• Zendesk, Freshdesk, Jira, Linear, GitHub — criar tickets ou issues a partir de uma conversa ou de um caso de erro.
• Cal.com — mostrar e reservar horários disponíveis, também pelo assistente de IA.
• Twilio — SMS pelo painel e rota de envio para o canal SMS.

Fontes de conhecimento

• Notion, Confluence — incluir conteúdo na base de conhecimento.
• Google Drive — na base de conhecimento, “Arquivos e Google Drive” (veja Base de conhecimento e central de ajuda).
• KB-Crawler — configurações do rastreamento do seu site.

Canais

• WhatsApp Business, Facebook Messenger, Instagram Direct — veja Canais.

Migrar de outro provedor

Em Migração (/app/migration), você importa dados de outra ferramenta de chat:

• Intercom e Crisp — pela interface deles ou por um arquivo de exportação; no Crisp, também artigos de ajuda em Markdown,
• Tidio — por um arquivo de exportação,
• Zendesk — pela exportação JSON completa e pela exportação da central de ajuda.

Como proceder:

1. Iniciar uma nova migração e escolher o destino (Para qual projeto?).
2. Conectar e ver o que há — você vê o que existe e uma amostra.
3. O que deve vir junto? — contatos, conversas, artigos.
4. Iniciar migração. Você pode Interromper ou Descartar tarefa.

O que você deve saber:

• As conversas importadas chegam ao painel encerradas.
• Contatos importados são considerados não verificados.
• Dados sensíveis nos textos são ocultados.
• Anexos vêm como link, não como arquivo.
• Uma segunda execução não cria nada em duplicidade.
• Suas credenciais do provedor antigo são excluídas após a execução.
• As interfaces dos provedores foram testadas sem contas reais neles; as importações de arquivos foram testadas de ponta a ponta com arquivos de exemplo.

Com Trocar o código, a conta converte um código de incorporação existente do Intercom ou Crisp em um código reactive.chat. Os comandos JavaScript boot, open, identify e track mantêm os mesmos nomes do Intercom.

Chaves de API

Em Chaves de API (/app/api-keys, proprietários e administradores), você cria chaves para a interface REST. Uma chave é mostrada exatamente uma vez; depois disso, reactive.chat armazena apenas uma impressão digital dela. Portanto, copie-a imediatamente para um local seguro.

Ao criar, você escolhe o que a chave pode fazer:

• somente leitura
• leitura e escrita
• só importação de dados de clientes — para a importação descrita em Dados de clientes no chat
• leitura + dados de visitantes ou leitura, escrita + dados de visitantes — só com esses escopos a chave vê nome, e-mail e telefone dos visitantes

A lista mostra nome, prefixo, quando e por quem a chave foi criada e quando foi usada pela última vez. Revogar tem efeito imediato e não pode ser desfeito.

Com uma chave, você também pode conectar reactive.chat a ferramentas de IA que usam o Model Context Protocol (MCP); a página mostra exemplos. O funcionamento da interface está descrito na seção Integração técnica.