## 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

1. Abra a área de **Integrações** nas Configurações.
2. Escolha a integração desejada e siga o fluxo de conexão (normalmente login/autorização ou
   inserção de chaves).
3. Para **webhooks**, cadastre a URL do seu endpoint e selecione os eventos de interesse; valide o
   recebimento no seu sistema.
4. Para a **API**, gere um token de acesso (perfil/agente) e use-o nas chamadas autenticadas.
5. 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.

## Veja também

- [Custom Scripts: injetar JS/CSS](/hc/ajuda/articles/administration-custom-scripts-pt-br)
- [Papéis personalizados e governança (RBAC)](/hc/ajuda/articles/administration-custom-roles-governanca-rbac-pt-br)
- [Logs de auditoria](/hc/ajuda/articles/administration-auditoria-pt-br)
- [Visão geral de Administração](/hc/ajuda/articles/administration-overview-pt-br)