Integração WhatsApp (Evolution API)
A integração WhatsApp utiliza a Evolution API para exibir fotos de perfil de clientes e fornecedores com base em seus números de telefone cadastrados.
Funcionalidade
Quando a integração está configurada, o sistema exibe automaticamente a foto de perfil do WhatsApp ao lado do nome da pessoa nas listagens e no detalhe de contas a pagar/receber.
Configuração por Empresa
A integração WhatsApp é configurada por empresa (não por workspace). Cada empresa pode ter suas próprias credenciais da Evolution API.
- Acesse
Configurações > Integrações > WhatsApp(/settings/integrations/whatsapp). - Selecione a empresa.
- Informe:
- URL da API — endpoint da Evolution API (deve ser HTTPS público)
- API Key — chave de autenticação da instância Evolution
- Clique em Salvar.
Privacidade e Segurança
- O sistema nunca acessa URLs privadas, de loopback ou link-local (proteção SSRF).
- As fotos de perfil são buscadas sob demanda e armazenadas em cache temporário.
- A API Key é criptografada em repouso.
Worker de Atualização
Um worker de manutenção ("Buscar Fotos") atualiza periodicamente as fotos de perfil dos contatos ativos. Só é executado quando a integração está configurada e ativa para a empresa.
Desconectar
Acesse a página de configuração e clique em Remover configuração. As fotos de perfil deixam de ser exibidas para a empresa desconectada.