SERVIÇO
Serviço: Chat Pró Oratrix
VOCÊ VAI PRECISAR
Antes de iniciar, tenha em mãos:
- Acesso de administrador ao Chat Pró Oratrix.
- O endereço de e-mail que será conectado.
- A senha da conta ou uma senha de aplicativo.
- O endereço do servidor IMAP.
- A porta do servidor IMAP.
- O endereço do servidor SMTP.
- A porta do servidor SMTP.
- O tipo de segurança utilizado pelo provedor: SSL, TLS ou STARTTLS.
- Permissão do provedor para conexões externas por IMAP e SMTP.
- Um computador conectado à internet.
Os servidores, portas e métodos de segurança variam conforme o provedor de e-mail. Consulte o painel ou a documentação do seu provedor antes de preencher os campos.
Não compartilhe senhas, senhas de aplicativo ou dados de acesso em grupos, capturas de tela ou mensagens públicas.
VISÃO GERAL
Neste tutorial, você aprenderá a conectar uma conta de e-mail ao Chat Pró Oratrix utilizando os protocolos IMAP e SMTP.
O IMAP será utilizado para receber os e-mails. O SMTP será utilizado para enviar as respostas.
Depois da configuração, os e-mails recebidos poderão aparecer no painel como tickets de atendimento, permitindo que sua equipe responda diretamente pelo Chat Pró Oratrix.
O QUE SIGNIFICAM IMAP E SMTP
IMAP é o protocolo utilizado para acessar e receber as mensagens da caixa de entrada.
SMTP é o protocolo utilizado para enviar mensagens.
Para o canal funcionar completamente, as duas configurações precisam estar corretas:
- IMAP para receber.
- SMTP para enviar.
PASSO A PASSO GUIADO
Etapa 1: Confirme os dados da conta de e-mail
- Defina qual endereço de e-mail será conectado.
- Confirme que você consegue acessar essa conta normalmente pelo Webmail.
- Envie um e-mail de teste diretamente pelo Webmail.
- Confirme que a conta consegue receber mensagens.
- Confirme que a conta consegue enviar mensagens.
- Verifique se a autenticação em duas etapas está ativa.
- Confirme com o provedor se será necessário utilizar uma senha de aplicativo.
Exemplos de contas:
atendimento@suaempresa.com.brsuporte@suaempresa.com.brcomercial@suaempresa.com.brfinanceiro@suaempresa.com.br
Antes de continuar, a conta deve estar funcionando normalmente fora do Chat Pró Oratrix.
Etapa 2: Localize os dados do provedor
Você precisará localizar os seguintes dados:
Dados para envio por SMTP
- Servidor SMTP.
- Porta SMTP.
- Tipo de segurança.
- Usuário.
- Senha ou senha de aplicativo.
- Endereço do remetente.
- Endereço de resposta, quando necessário.
Dados para recebimento por IMAP
- Servidor IMAP.
- Porta IMAP.
- Tipo de segurança.
- Usuário.
- Senha ou senha de aplicativo.
- Nome da pasta que será monitorada.
Essas informações normalmente estão disponíveis:
- No painel do provedor de hospedagem.
- Na central de ajuda do provedor.
- Na área de configuração de clientes de e-mail.
- Com o administrador responsável pelo domínio.
- Com a empresa responsável pelo servidor de e-mail.
Não utilize configurações encontradas aleatoriamente na internet. Os dados precisam corresponder exatamente ao provedor da sua conta.
Etapa 3: Conheça as portas mais utilizadas
SMTP
- Porta
587: normalmente utilizada com TLS ou STARTTLS. - Porta
465: normalmente utilizada com SSL.
IMAP
- Porta
993: normalmente utilizada com SSL ou TLS. - Porta
143: utilizada conforme a configuração do provedor, podendo exigir STARTTLS.
Essas portas são apenas referências comuns. Utilize sempre os dados fornecidos pelo seu provedor.
Etapa 4: Acesse o Painel Admin
- Acesse o Chat Pró Oratrix pelo endereço fornecido pela Oratrix.
- Informe seu usuário e sua senha.
- Clique em Entrar.
- Abra o Painel Admin.
- No menu lateral, clique em Administração.
- Clique em Canais.
- Aguarde a lista de canais cadastrados aparecer.
Etapa 5: Adicione um novo canal
- Clique em Adicionar canal.
- Aguarde a abertura da tela de cadastro.
- Localize o campo referente ao tipo do canal.
- Selecione E-mail (IMAP/SMTP).
- Confirme que o tipo selecionado está correto.
Não selecione Webmail Gmail quando a conta será configurada diretamente por IMAP e SMTP.
Etapa 6: Informe o nome do canal
- No campo Nome do canal, digite uma identificação clara.
Exemplos:
- E-mail Comercial
- E-mail Suporte
- E-mail Financeiro
- Atendimento por E-mail
- Caixa de Entrada Principal
- Evite nomes genéricos como:
- Canal 1
- Teste
- E-mail novo
- Caso exista a opção Canal padrão, defina se essa será a conta principal utilizada pelo sistema.
Um nome claro facilita a identificação da conta pelos administradores e atendentes.
CONFIGURAÇÃO SMTP
Etapa 7: Informe o servidor SMTP
- Localize o campo Servidor SMTP.
- Digite o endereço fornecido pelo seu provedor.
Exemplos de formato:
smtp.seudominio.com.brmail.seudominio.com.br
- Não inclua
http://. - Não inclua
https://. - Não adicione espaços antes ou depois do endereço.
- Confirme que o nome do servidor está completo.
Os exemplos são apenas ilustrativos. Utilize o endereço informado pelo seu provedor.
Etapa 8: Informe a porta SMTP
- Localize o campo Porta SMTP.
- Digite a porta informada pelo provedor.
- Confirme se a porta corresponde ao tipo de segurança.
Exemplos comuns:
- Porta
587com TLS ou STARTTLS. - Porta
465com SSL.
Uma porta incorreta impedirá o envio das mensagens.
Etapa 9: Configure a segurança SMTP
- Localize a opção Conexão segura, SSL, TLS ou equivalente.
- Selecione o método informado pelo provedor.
- Confirme a combinação entre servidor, porta e segurança.
- Não escolha o tipo de segurança aleatoriamente.
Etapa 10: Informe o usuário SMTP
- Localize o campo Usuário SMTP.
- Informe o endereço completo da conta.
Exemplo:
atendimento@suaempresa.com.br
- Não informe apenas a parte anterior ao
@, salvo quando o provedor orientar dessa forma. - Não adicione espaços.
- Confirme se o domínio está correto.
Etapa 11: Informe a senha SMTP
- Localize o campo Senha SMTP, Senha ou App Password.
- Digite a senha da conta ou a senha de aplicativo.
- Caso a autenticação em duas etapas esteja ativada, confirme se o provedor exige senha de aplicativo.
- Não utilize uma senha antiga.
- Não deixe espaços antes ou depois.
- Não compartilhe essa informação.
Alguns provedores bloqueiam o acesso por senha comum quando a autenticação em duas etapas está ativa.
Etapa 12: Informe o e-mail remetente
- Localize o campo E-mail remetente, From ou equivalente.
- Informe o endereço que aparecerá como remetente das mensagens.
Exemplo:
atendimento@suaempresa.com.br
- Dê preferência ao mesmo endereço utilizado na autenticação SMTP.
- Utilize outro endereço somente quando o provedor permitir.
- Não informe um endereço inexistente.
Esse será o endereço apresentado ao cliente quando ele receber a resposta.
Etapa 13: Informe o e-mail de resposta
- Localize o campo E-mail de resposta, Reply-To ou equivalente.
- Informe o endereço que deverá receber as respostas dos clientes.
- Utilize o mesmo endereço do canal quando não houver necessidade de direcionar as respostas para outra conta.
Exemplo:
atendimento@suaempresa.com.br
Um endereço de resposta incorreto pode direcionar as mensagens para outra caixa postal.
CONFIGURAÇÃO IMAP
Etapa 14: Utilize a detecção automática, quando disponível
- Localize a seção Configuração IMAP.
- Informe o endereço completo da conta.
- Clique em Detectar, caso essa opção esteja disponível.
- Aguarde o sistema tentar identificar o servidor e a porta.
- Revise os dados encontrados.
- Compare as informações com a documentação do provedor.
- Corrija manualmente caso algum dado esteja diferente.
A detecção automática é apenas uma tentativa. Ela não substitui a confirmação dos dados com o provedor.
Etapa 15: Informe o servidor IMAP
- Localize o campo Host IMAP ou Servidor IMAP.
- Digite o endereço fornecido pelo provedor.
Exemplos de formato:
imap.seudominio.com.brmail.seudominio.com.br
- Não inclua
http://. - Não inclua
https://. - Não adicione espaços.
- Confirme a grafia.
Etapa 16: Informe a porta IMAP
- Localize o campo Porta IMAP.
- Digite a porta informada pelo provedor.
- Confirme se a porta corresponde ao tipo de segurança.
Exemplos comuns:
- Porta
993com SSL ou TLS. - Porta
143conforme a configuração do provedor.
Uma porta incorreta impedirá o recebimento dos e-mails.
Etapa 17: Configure a segurança IMAP
- Localize a opção TLS/SSL, Conexão segura ou equivalente.
- Selecione o método informado pelo provedor.
- Confirme se a porta utilizada é compatível.
- Mantenha a conexão protegida sempre que possível.
O uso de SSL ou TLS protege os dados transmitidos entre o Chat Pró Oratrix e o servidor de e-mail.
Etapa 18: Informe o usuário IMAP
- Localize o campo Usuário IMAP.
- Informe o endereço completo da conta.
Exemplo:
atendimento@suaempresa.com.br
- Caso exista o botão Igual ao SMTP, clique nele para copiar os dados.
- Revise o endereço.
- Confirme se não existem espaços.
Etapa 19: Informe a senha IMAP
- Localize o campo Senha IMAP.
- Informe a senha da conta ou a senha de aplicativo.
- Utilize a mesma credencial do SMTP quando o provedor determinar.
- Confirme se a autenticação em duas etapas exige senha de aplicativo.
- Não utilize uma senha revogada.
- Não compartilhe a credencial.
Etapa 20: Escolha a pasta monitorada
- Localize o campo Caixa, Mailbox ou Pasta.
- Informe:
INBOX
- Utilize outra pasta somente quando houver uma necessidade específica.
- Confirme com o provedor o nome exato da pasta.
- Respeite letras maiúsculas e minúsculas quando o servidor exigir.
A opção
INBOXnormalmente corresponde à caixa de entrada principal.
Etapa 21: Configure o intervalo de verificação
- Localize o campo Intervalo.
- Informe o tempo, em segundos, entre as verificações de novos e-mails.
- Utilize
30segundos como referência inicial. - Não utilize intervalos muito baixos sem orientação.
- Salve a configuração.
Intervalos excessivamente curtos podem aumentar o consumo de recursos ou provocar bloqueios no servidor.
CONFIGURAÇÕES ADICIONAIS
Etapa 22: Mantenha a validação do certificado TLS
- Localize a opção Validar certificado TLS.
- Mantenha a opção ativada.
- Desative somente quando houver orientação técnica específica.
- Não ignore alertas de certificado sem confirmação.
Desativar a validação reduz a segurança da conexão.
Etapa 23: Configure Keepalive ou IDLE
- Localize a opção Keepalive, IDLE ou equivalente.
- Ative quando o provedor oferecer suporte.
- Essa função mantém a conexão com o servidor ativa.
- Ela pode permitir o recebimento mais rápido dos novos e-mails.
- Caso ocorram desconexões frequentes, revise a configuração.
Etapa 24: Configure uma assinatura
- Localize o campo Assinatura.
- Digite o texto que será adicionado ao final das mensagens.
- Caso o campo aceite HTML, utilize somente códigos simples.
Exemplo:
<p>Atenciosamente,<br><strong>Equipe de Atendimento</strong></p>
- Revise a formatação.
- Não utilize imagens muito grandes.
- Não inclua informações internas ou confidenciais.
- Salve a assinatura.
A assinatura será adicionada automaticamente aos e-mails enviados pelo canal, conforme a configuração disponível.
Etapa 25: Configure o webhook, quando necessário
- Localize a opção Habilitar Webhook do Canal.
- Mantenha desativada caso sua empresa não utilize integrações externas.
- Ative somente quando possuir uma URL válida.
- Informe a URL fornecida pelo responsável técnico.
- Salve a configuração.
- Faça um teste da integração.
O webhook é um recurso avançado. Uma URL incorreta pode impedir o funcionamento da integração externa.
ATRIBUIÇÕES DO CANAL
Etapa 26: Escolha a fila responsável
- Localize o campo Fila.
- Escolha o departamento que receberá os novos e-mails.
Exemplos:
- Comercial
- Suporte
- Financeiro
- Atendimento Geral
- Confirme que a fila está ativa.
- Salve a configuração.
Uma fila incorreta pode encaminhar os tickets para o departamento errado.
Etapa 27: Escolha um usuário responsável
- Localize o campo Usuário.
- Selecione um atendente caso os novos e-mails devam ser direcionados inicialmente para uma pessoa específica.
- Deixe o campo vazio quando a distribuição for realizada pela fila.
- Confirme se o usuário está ativo.
Etapa 28: Configure o Chat Flow, quando disponível
- Localize o campo ChatFlow.
- Selecione um fluxo somente quando a operação utilizar automações compatíveis com e-mail.
- Deixe o campo vazio quando não houver um fluxo específico.
- Faça testes antes de utilizar em produção.
SALVAMENTO E CONEXÃO
Etapa 29: Revise os dados preenchidos
Antes de salvar, confirme:
- Nome do canal.
- Servidor SMTP.
- Porta SMTP.
- Segurança SMTP.
- Usuário SMTP.
- Senha SMTP.
- E-mail remetente.
- E-mail de resposta.
- Servidor IMAP.
- Porta IMAP.
- Segurança IMAP.
- Usuário IMAP.
- Senha IMAP.
- Pasta
INBOX. - Intervalo de verificação.
- Fila ou usuário responsável.
Etapa 30: Salve o canal
- Clique em Salvar.
- Aguarde o processamento.
- Observe se o sistema apresenta alguma mensagem de erro.
- Caso apareça um erro, revise o campo indicado.
- Corrija a informação.
- Salve novamente.
O canal estará criado quando aparecer na lista de canais.
Etapa 31: Conecte o canal
- Localize o canal na lista.
- Clique em Conectar, quando essa opção estiver disponível.
- Aguarde a validação.
- Verifique o status apresentado.
- Confirme se o canal aparece como conectado ou ativo.
TESTE DE FUNCIONAMENTO
Etapa 32: Faça um teste de recebimento
- Utilize outro endereço de e-mail.
- Envie uma mensagem para a conta conectada.
Exemplo de assunto:
Teste de recebimento no Chat Pró Oratrix
Exemplo de mensagem:
Olá, esta é uma mensagem de teste para validar o recebimento pelo canal de e-mail.
- Aguarde o intervalo configurado.
- Abra a tela de atendimentos.
- Procure um novo ticket.
- Abra o atendimento.
- Confirme se o remetente está correto.
- Confirme se o assunto aparece.
- Confirme se o conteúdo da mensagem está completo.
O recebimento estará funcionando quando o e-mail aparecer como ticket no painel.
Etapa 33: Faça um teste de resposta
- Abra o ticket criado durante o teste.
- Digite uma resposta.
Exemplo:
Olá! Recebemos seu e-mail e estamos respondendo pelo Chat Pró Oratrix.
- Clique em Enviar.
- Abra a caixa de entrada utilizada no teste.
- Aguarde alguns minutos.
- Verifique a caixa de entrada.
- Verifique também a pasta de spam.
- Confirme se o remetente está correto.
- Confirme se a assinatura foi adicionada.
O envio estará funcionando quando a resposta chegar ao endereço do cliente.
Etapa 34: Teste o envio e recebimento de anexos
- Envie um novo e-mail com um arquivo pequeno anexado.
- Aguarde o recebimento no painel.
- Abra o ticket.
- Confirme se o arquivo aparece.
- Visualize ou baixe o arquivo.
- Responda com outro anexo pequeno.
- Confirme se o destinatário recebeu.
O tamanho permitido depende dos limites do provedor de e-mail.
OBSERVAÇÕES IMPORTANTES
- Os dados de IMAP e SMTP variam conforme o provedor.
- O SMTP é responsável pelo envio.
- O IMAP é responsável pelo recebimento.
- A porta deve corresponder ao tipo de segurança.
- O usuário normalmente é o endereço de e-mail completo.
- Alguns provedores exigem senha de aplicativo.
- A senha normal pode não funcionar quando a autenticação em duas etapas está ativa.
- A pasta monitorada normalmente é
INBOX. - O intervalo inicial recomendado é de 30 segundos.
- A validação do certificado TLS deve permanecer ativa.
- O Keepalive ou IDLE pode melhorar o tempo de recebimento.
- O servidor precisa aceitar conexões externas.
- O firewall precisa permitir as portas utilizadas.
- O tamanho dos anexos depende do provedor.
- Alguns provedores limitam a quantidade de mensagens enviadas.
- Alterações de senha podem desconectar o canal.
- Mudanças no servidor exigirão atualização da configuração.
- O nome e a posição dos campos podem variar conforme a versão do Chat Pró Oratrix.
DICAS E BOAS PRÁTICAS
- Utilize uma conta corporativa exclusiva para atendimento.
- Evite contas pessoais de funcionários.
- Crie uma senha de aplicativo exclusiva para a integração.
- Guarde as credenciais em um gerenciador de senhas.
- Utilize sempre SSL ou TLS.
- Mantenha a validação do certificado ativa.
- Use o endereço completo como usuário.
- Configure a pasta como
INBOX, salvo orientação diferente. - Faça testes após qualquer alteração.
- Evite intervalos muito baixos.
- Verifique regularmente se o canal está conectado.
- Revise a fila responsável.
- Teste o funcionamento dos anexos.
- Monitore a pasta de spam.
- Mantenha espaço disponível na caixa postal.
- Não altere a senha sem atualizar o canal.
- Confirme o remetente antes de colocar o canal em produção.
- Utilize uma assinatura profissional e curta.
SOLUÇÃO DE PROBLEMAS
O canal não conecta
Uma possível causa é algum dado de servidor, porta, usuário ou senha estar incorreto.
Verifique:
- Se o servidor SMTP está correto.
- Se a porta SMTP está correta.
- Se o SSL, TLS ou STARTTLS está configurado corretamente.
- Se o usuário SMTP está completo.
- Se a senha SMTP está atualizada.
- Se o servidor IMAP está correto.
- Se a porta IMAP está correta.
- Se o usuário IMAP está completo.
- Se a senha IMAP está atualizada.
- Se o provedor permite conexões externas.
- Se o firewall permite as portas utilizadas.
O canal recebe, mas não envia
Uma possível causa é um erro na configuração SMTP.
Verifique:
- O servidor SMTP.
- A porta SMTP.
- O tipo de segurança.
- O usuário SMTP.
- A senha ou senha de aplicativo.
- O endereço do remetente.
- Se a conta consegue enviar pelo Webmail.
- Se o provedor bloqueou temporariamente os envios.
- Se o limite de envio foi atingido.
O canal envia, mas não recebe
Uma possível causa é um erro na configuração IMAP.
Verifique:
- O servidor IMAP.
- A porta IMAP.
- O tipo de segurança.
- O usuário IMAP.
- A senha IMAP.
- Se a pasta está configurada como
INBOX. - Se a conta consegue receber pelo Webmail.
- Se o intervalo de verificação está preenchido.
- Se o canal está conectado.
- Se o Keepalive ou IDLE está ativo, quando necessário.
Aparece erro de autenticação
- Confirme o endereço completo do usuário.
- Digite novamente a senha.
- Verifique se a autenticação em duas etapas está ativa.
- Confirme se é necessário utilizar uma senha de aplicativo.
- Gere uma nova senha de aplicativo.
- Atualize os campos SMTP e IMAP.
- Salve novamente.
- Teste a conexão.
Aparece erro de certificado
- Confirme se o servidor está correto.
- Verifique se a porta corresponde ao SSL ou TLS.
- Confirme se o certificado do servidor está válido.
- Não desative a validação sem orientação.
- Solicite ao responsável pelo servidor a correção do certificado.
As mensagens demoram para aparecer
- Verifique o intervalo de consulta.
- Confirme se o intervalo está configurado corretamente.
- Verifique se o Keepalive ou IDLE está ativo.
- Confirme se o servidor oferece suporte ao recurso.
- Verifique a estabilidade da internet.
- Confirme se o servidor está respondendo normalmente.
Os e-mails não aparecem como tickets
- Confirme se o canal está conectado.
- Verifique a fila configurada.
- Procure em atendimentos pendentes, abertos e resolvidos.
- Confirme se o e-mail chegou à pasta
INBOX. - Verifique se a mensagem foi direcionada para spam.
- Envie um novo teste.
- Aguarde o intervalo configurado.
- Atualize a página.
A senha foi alterada e o canal parou
- Acesse a edição do canal.
- Atualize a senha SMTP.
- Atualize a senha IMAP.
- Caso utilize senha de aplicativo, gere uma nova.
- Salve.
- Reconecte o canal.
- Faça um teste de envio.
- Faça um teste de recebimento.
O anexo não chega
- Verifique o tamanho do arquivo.
- Confirme o limite do provedor.
- Teste com um arquivo menor.
- Verifique se o tipo de arquivo é permitido.
- Confirme se a caixa postal possui espaço.
- Verifique se o provedor bloqueou o anexo.
- Consulte a pasta de spam.
Os e-mails estão indo para a fila errada
- Abra o Painel Admin.
- Acesse Canais.
- Edite o canal de e-mail.
- Localize o campo Fila.
- Selecione o departamento correto.
- Salve.
- Envie um novo e-mail de teste.
O servidor recusa a conexão
Uma possível causa é bloqueio de firewall ou restrição do provedor.
Verifique:
- Se as portas estão liberadas.
- Se o endereço do servidor está correto.
- Se o servidor aceita conexões externas.
- Se existe bloqueio por endereço IP.
- Se o provedor exige autorização adicional.
- Se a conta está bloqueada.
- Se houve muitas tentativas de login incorretas.
O provedor exige autenticação moderna
Alguns provedores podem não aceitar usuário e senha convencionais.
Nesse cenário:
- Consulte a documentação do provedor.
- Verifique se existe senha de aplicativo.
- Confirme se IMAP e SMTP estão habilitados.
- Verifique se a organização bloqueia autenticação básica.
- Solicite orientação ao administrador do serviço de e-mail.
- Não altere políticas de segurança sem autorização.
RESULTADO ESPERADO
Ao concluir o procedimento:
- O canal de e-mail aparecerá na lista de canais.
- O servidor IMAP estará conectado.
- O servidor SMTP estará autenticado.
- Os e-mails recebidos aparecerão como tickets.
- Os atendentes poderão responder pelo Chat Pró Oratrix.
- As respostas serão enviadas pelo endereço configurado.
- Os anexos poderão ser recebidos e enviados dentro dos limites do provedor.
- Os tickets poderão ser direcionados para a fila ou usuário escolhido.
RESUMO FINAL
Com este procedimento, uma conta de e-mail será conectada ao Chat Pró Oratrix por meio de IMAP e SMTP.
O IMAP permitirá o recebimento das mensagens e o SMTP permitirá o envio das respostas.
Depois de preencher os servidores, portas, dados de segurança, usuário e senha, salve o canal e faça testes completos de recebimento, resposta e anexos.
KEYWORDS
E-mail, IMAP, SMTP, Webmail, Chat Pró Oratrix
Peça ajuda ao ChatGPT da Oratrix
A I.A. da Oratrix no ChatGPT poderá tirar dúvidas e te guiar passo a passo no suporte.