Integrações externas
Esta tela configura as credenciais dos serviços externos usados pelo CRM — envio de e-mail, WhatsApp, SMS, inteligência artificial e notificações push. Aqui você informa as chaves de acesso, ativa o serviço e testa a conexão de verdade.
Como acessar
CRM → Configurações → Integrações (rota /crm/configuracoes/integracoes-config).
O que você vê nesta tela
Uma lista de cartões, um para cada provedor disponível (por exemplo Z-API, Amazon SES, Twilio, OpenAI, FCM). Cada cartão mostra:
| Elemento | O que é |
|---|---|
| Nome do provedor | Identificação do serviço |
| Verificação | Quando foi verificado pela última vez e o resultado (ok / erro), ou "Nunca verificado" |
| Etiqueta de status | Ativo, Inativo (configurado mas desligado) ou Não configurado |
Clicar em um cartão abre o painel de configuração daquele provedor.
O que dá pra fazer aqui
Configurar um provedor
- Clique no cartão do provedor desejado.
- Preencha os campos de credenciais exibidos (eles variam conforme o provedor).
- Ligue a chave Ativar este provider se quiser que ele passe a ser usado.
- Clique em Salvar configuração. Aparece a confirmação "Configuração salva".
Testar a conexão de verdade
Dentro do painel do provedor há o bloco Testar conexão real. O teste executa uma ação real conforme o serviço — por exemplo, envia um e-mail, consulta o status da instância de WhatsApp ou lista os modelos de IA.
- Se o provedor exigir, informe um Destinatário de teste (e-mail ou número, conforme indicado pelo texto de ajuda).
- Clique em Testar agora.
- O resultado aparece abaixo, em verde (sucesso, com ✓) ou vermelho (falha, com ✗) e a mensagem retornada pelo serviço.
Cada provedor mostra um texto de ajuda explicando exatamente o que o teste faz. Alguns testes (como IA e notificação push) só validam a credencial, sem disparar nada.
Dicas e observações
- Chaves sensíveis ficam mascaradas depois de salvas. Para trocá-las, digite o novo valor; se deixar o campo como está, o valor anterior é mantido.
- O status do cartão muda conforme você configura e ativa o provedor; o resultado do último teste fica registrado como data e situação da verificação.
- Em ambiente de desenvolvimento, o envio de e-mail de teste pode ser redirecionado para um endereço de segurança em vez do destinatário informado.