Como conectar o SupportCandy ao Microsoft Exchange com DavMail

As versões modernas do SupportCandy removeram o antigo “Local Exchange” conector e agora oferecem apenas três opções de conexão de e-mail — IMAP básico, Gmail API e Microsoft Exchange API12. Se suas caixas de correio estão em Exchange local, Exchange híbrido ou tenants do Office 365 onde a rota da API do Exchange está bloqueada ou exige um registro complicado no Azure, você ainda pode levar todos os e-mails de suporte direto para o WordPress: execute DavMail como uma ponte IMAP e deixe o SupportCandy consumi-lo como qualquer outro servidor de e-mail.

Abaixo está um guia passo a passo completo, otimizado para SEO, que você pode copiar e colar no seu blog de tecnologia.

Por que o DavMail?

1. Tradução de protocolo – O DavMail fala EWS/OWA no back-end e expõe portas padrão (IMAP, POP, SMTP, CalDAV, LDAP) na frente3.
2. Funciona com MFA & autenticação moderna – Os O365Modern e O365Interactive modos fazem login via OAuth2, então tenants do Office 365 com MFA estão cobertos45.
3. Roda em qualquer lugar – Aplicativo Java; funciona no Windows, macOS, Linux ou dentro de um contêiner Docker/LXC.
4. Mantém o SupportCandy simples – O SupportCandy só vê “localhost:1143” (ou 993 se você habilitar SSL) e importa tickets pela sua tela IMAP de sempre6.

Pré-requisitos

Componente	Versão mínima	Notas
WordPress	5.6+	Exigido pelo SupportCandy7.
SupportCandy Core	3.x	Mais o Email Piping add-on.
Java Runtime	8+	Necessário para rodar o DavMail.
Exchange	2007+ (EWS) ou Office 365	A URL de OWA/EWS deve ser acessível a partir do host do DavMail4.

Passo 1 – Baixar & instalar o DavMail

Windows

1. Baixe o instalador no SourceForge (davmail-win64.exe).
2. Execute como Administrador; mantenha as portas padrão (1143 IMAP, 1025 SMTP, 1080 CalDAV etc.) para uma configuração de estação de trabalho3.

Linux (serviço para todo o sistema)

bashsudo apt install davmail
sudo systemctl enable davmail

Docker one-liner

bashdocker run -d \
  -e DAVMAIL_URL=https://outlook.office365.com/EWS/Exchange.asmx \
  -e DAVMAIL_MODE=O365Modern \
  -p 1143:1143 -p 1025:1025 \
  --name davmail gatewayapps/davmail

Passo 2 – Configurar o DavMail

Abrir davmail.properties (GUI → Settings… ou /etc/davmail.properties).

Entradas essenciais:

text# Talk to Exchange
davmail.url=https://outlook.office365.com/EWS/Exchange.asmx   # or on-prem OWA/EWS URL
davmail.mode=O365Modern                                       # O365Modern, O365Interactive or EWS[8][50]

# IMAP gateway
davmail.imapPort=1143                                         # switch to 993 if you want SSL[7]

# Run headless on a server
davmail.server=true

Salve & reinicie o DavMail.

Teste com Telnet:

bashtelnet localhost 1143
* OK IMAP4rev1 DavMail server ready

Passo 3 – Reforce com SSL (opcional, mas recomendado)

1. Gere um keystore PKCS#12 ou importe um certificado de CA8.

bash
keytool -genkey -storetype PKCS12 -keystore /opt/davmail.p12 \
        -keypass CHANGEIT -storepass CHANGEIT \
        -dname "CN=support.example.com,OU=IT,O=Company,L=City,C=US"

2. Adicione ao davmail.properties:

text
davmail.ssl.keystoreType=PKCS12
davmail.ssl.keystoreFile=/opt/davmail.p12
davmail.ssl.keyPass=CHANGEIT
davmail.ssl.keystorePass=CHANGEIT
davmail.imapPort=993            # secure IMAPS
davmail.smtpPort=465            # secure SMTPS[44]

3. Reinicie e teste de novo: openssl s_client -connect localhost:993.

Passo 4 – Aponte o SupportCandy para o DavMail

1. Support → Settings → Email Piping → IMAP.
2. Preencha o formulário:

textoEmail address:  [email protected]
Password:        <mailbox password or app-password>
Incoming server: 127.0.0.1
Port:            1143   (or 993 with SSL)
Encryption:      None   (or SSL)

Agora o SupportCandy vai buscar todo e-mail que chegar na caixa de entrada do Exchange e transformá-lo em tickets. Lembre que a documentação afirma que o Exchange “não é permitido” via IMAP básico6; o DavMail contorna isso porque o lado do Exchange é EWS, enquanto o SupportCandy vê IMAP padrão.

Passo 5 – Rodar o DavMail como serviço

Exemplo de systemd (/etc/systemd/system/davmail.service)

text
[Unit]
Description=DavMail Exchange Gateway
After=network.target

[Service]
ExecStart=/usr/bin/davmail /etc/davmail.properties
SuccessExitStatus=143
Restart=always
User=davmail

[Install]
WantedBy=multi-user.target

bash
sudo systemctl daemon-reload
sudo systemctl start davmail
sudo systemctl enable davmail

Guia rápido de solução de problemas

Sintoma	Causa provável	Solução
Porta já em uso nos logs do DavMail9	Outro processo (ou instância anterior do DavMail) usando as portas 1143/1025	fuser -k -n tcp 1143 e reinicie o serviço.
Broken pipe ou timeout em mensagens grandes10	Throttling do Exchange ou cliente ocioso	Aumente davmail.timeout (ms) nas propriedades para 120000.
Loop de MFA no O365	Usar o modo EWS em um tenant com autenticação moderna exigida	Mude para O365Modern ou O365Interactive5.
O SupportCandy não busca nada	Porta ou criptografia errada	Use 1143→None ou 993→SSL. Verifique as credenciais da caixa de correio.
E-mails duplicados ou não marcados como lidos	Defina “Leave a copy on server” no SupportCandy como desativado e habilite “Mark message read after fetch”.

Considerações finais

Até que o SupportCandy volte a oferecer um conector próprio para Exchange local, o DavMail é a solução alternativa mais rápida e sem custo para manter suas caixas do Microsoft Exchange ou Office 365 fluindo para o WordPress. Combinado com o gerenciamento robusto de tickets do SupportCandy e o gateway compatível com OAuth do DavMail, você tem automação de helpdesk de nível empresarial sem mensalidades de SaaS ou permissões complexas no Azure.

Conecte, proteja e deixe seus agentes focarem em resolver tickets — e não em brigar com as APIs do Exchange.

Boas integrações!