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.

1. Acesse Configurações > Integrações > WhatsApp (/settings/integrations/whatsapp).
2. Selecione a empresa.
3. Informe:
   • URL da API — endpoint da Evolution API (deve ser HTTPS público)
   • API Key — chave de autenticação da instância Evolution
4. 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.