Visão geral
As Integrações conectam a ConversaLabs ao resto do seu ecossistema. A partir da área de integrações você ativa conexões prontas e cria pontos de extensão próprios:
- Slack: espelha conversas em um canal do Slack e responda de lá.
- Dialogflow: conecte um bot do Dialogflow para respostas automáticas.
- Notion e Linear: leve contexto da conversa para suas ferramentas de produtividade e desenvolvimento.
- Shopify: traga dados de pedidos/cliente da sua loja para o atendimento.
- Webhooks: receba eventos da plataforma em um endpoint seu, em tempo real.
- Aplicativos de painel (Dashboard Apps): incorpore uma aplicação web sua ao lado da conversa.
- API: automatize e integre via tokens de acesso.
Pré-requisitos
- Perfil de Administrador para configurar integrações.
- Credenciais/contas das ferramentas que você vai conectar (por exemplo, workspace do Slack, projeto do Dialogflow, loja Shopify).
- Para webhooks/API: um endpoint acessível e/ou um token de acesso gerado na conta.
Passo a passo
- Abra a área de Integrações nas Configurações.
- Escolha a integração desejada e siga o fluxo de conexão (normalmente login/autorização ou inserção de chaves).
- Para webhooks, cadastre a URL do seu endpoint e selecione os eventos de interesse; valide o recebimento no seu sistema.
- Para a API, gere um token de acesso (perfil/agente) e use-o nas chamadas autenticadas.
- Teste a integração com uma conversa real antes de colocar em produção.
Configurações & opções
- Conexões por autorização (Slack, Shopify, etc.): seguem o login da ferramenta externa.
- Conexões por chave/projeto (Dialogflow): exigem credenciais do provedor.
- Webhooks por evento: você escolhe quais eventos quer receber.
- Tokens de API: trate-os como senhas; revogue se vazarem ou caírem em desuso.
Casos de uso
- Notificar um canal do Slack quando chega uma nova conversa.
- Triagem automática com um bot de Dialogflow antes de chegar ao agente.
- Criar um item no Linear a partir de um bug relatado pelo cliente.
- Mostrar dados do pedido da Shopify direto na tela da conversa.
- Sincronizar eventos com seu CRM ou ERP via webhooks.
Dicas, limites e boas práticas
- Comece por uma integração, valide o fluxo e só então adicione outras.
- Para webhooks, implemente idempotência e responda rápido (processe em segundo plano).
- Guarde tokens em variáveis de ambiente do seu sistema — nunca no código-fonte público.
- Revise integrações e tokens periodicamente; remova o que não é mais usado.
Solução de problemas
- A integração não conecta: confira credenciais/permissões e tente reautorizar.
- O webhook não chega: verifique se a URL é pública, responde com sucesso (2xx) e está nos eventos certos.
- Erro 401 na API: o token está incorreto, expirado ou foi revogado — gere um novo.
- Não vejo a integração desejada: ela pode depender do plano ou de uma habilitação específica.