SuperMailbox · guia de integração com CRM

Conecte o SuperMailbox ao seu CRM

Cada usuário do CRM recebe uma conexão OAuth segura com as caixas de e-mail que escolher. Seu CRM pode localizar conversas com clientes, mostrar contexto de e-mail verificado e preparar ou enviar respostas pelo servidor MCP do SuperMailbox.

Como a conexão funciona

01

Conecte uma caixa de e-mail

O usuário conecta Gmail, Outlook ou outra caixa compatível ao SuperMailbox. O login no provedor de e-mail é separado da autorização do CRM.

02

Autorize o CRM

O CRM abre o OAuth do SuperMailbox no navegador. O usuário entra, confere o cliente e as permissões solicitadas e aprova a conexão.

03

Use as ferramentas MCP

O CRM chama o servidor MCP remoto com o token do usuário. O usuário escolhe uma caixa autorizada, e o CRM opera dentro dessa permissão.

Configurações da conexão

Use um cliente ou SDK MCP com suporte a Streamable HTTP remoto e descoberta de OAuth. Ele deve gerenciar a autorização no navegador e enviar o token de acesso nas solicitações MCP.

URL do servidor MCP
https://api.supermailbox.app/mcp
Autorização
OAuth 2.0 · Authorization Code · PKCE S256
Permissões
openid email mail.accounts.read mail.messages.read mail.send

Solicite somente os acessos necessários ao fluxo. Um CRM que lê conversas e envia respostas pode solicitar:

Encontre e verifique uma conversa

  • Chame list_mail_accounts para o usuário escolher uma caixa disponível. canSend é apenas uma indicação; a permissão de envio é conferida novamente na execução.
  • Busque candidatos com search_emails ou search_threads_by_recipient. A busca por destinatário retorna apenas metadados; obtenha e verifique a conversa antes de vinculá-la a um registro do CRM.
  • Os resultados podem ser limitados ou incompletos. Considere os campos coverage e completeness; um resultado parcial vazio não prova que não há mensagens.
  • Os IDs de caixas, mensagens e conversas são opacos e pertencem à autorização do usuário atual. Resolva e valide tudo na mesma conexão.

Prepare e envie respostas com segurança

  • Antes da confirmação do envio, mostre no CRM a caixa, o destinatário e o texto da resposta selecionados.
  • send_email e reply_to_email retornam uma operação na fila. Consulte get_mail_action com o mesmo ID de operação e as permissões necessárias até um estado final.
  • O recibo de fila não comprova a entrega. Se o envio estiver incerto, verifique a mesma operação; nunca repita automaticamente com um novo ID.

Segurança e controle de acesso

  • Use o fluxo OAuth authorization-code com PKCE S256 pela descoberta suportada pelo cliente MCP. Mantenha segredos e tokens no servidor; não os exponha ao código do navegador nem aos logs.
  • Crie uma conexão separada para cada usuário do CRM. Não compartilhe tokens ou IDs opacos de e-mail entre usuários.
  • Solicite mail.send somente se o CRM precisar enviar mensagens. O usuário pode revogar a conexão do CRM nas configurações de aplicativos conectados do SuperMailbox.