Um novo perfil.
Um e-mail só dele.
Dados brasileiros para seus cadastros, com um endereço exclusivo no seu domínio Catch-all.
Acesso por token
Use seu token para configurar o domínio e gerar perfis.
Seu Catch-all
Defina onde os novos endereços recebem mensagens.
Pronto para cadastrar
Gere um perfil completo e use os dados no sistema que está testando.
Cada clique reserva um novo e-mail.
Abrir caixa de entrada ↗Ver todos os dados do perfil
Use em outros sistemas
Instale o balão uma vez no seu sistema. O usuário gera e consulta o perfil dentro dele, copia cada informação e cola onde precisar. A API também está disponível para integrações próprias.
E-mail, CPF e CNPJ são reservados no PostgreSQL. Se a origem repetir um documento, outra pessoa é solicitada, com até 8 tentativas. Os dados do perfil aceito são preservados; apenas o e-mail é ajustado. Documentos do histórico também ficam reservados, sem modificar registros antigos. Essa verificação abrange os perfis registrados neste gerador.
GET /health — Saúde da API e banco. Público.
GET /api/profiles/:id/messages — Últimos 50 e-mails do perfil e estado de
sincronização. Token.
GET /api/profiles/:id/messages/:messageId — Texto, HTML tratado, códigos
e anexos. Token.
GET /api/profiles/:id/messages/:messageId/attachments/:attachmentId —
Baixar anexo desse perfil. Token.
GET /api/widget-policy?origin=... — Verifica se o balão pode carregar
naquela origem. Público.
GET /api/config — Domínio e caixa de entrada. Público.
GET /api/admin/config — Ler configuração. Token.
PUT /api/admin/config — Salvar domínio e link. Token.
POST /api/profiles — Gerar perfil único. Token, corpo {}.
GET /api/profiles?email=...&cursor=... — Histórico em páginas de 10,
com busca por e-mail. Token.
GET /api/profiles/:id — Reabrir os dados completos de um perfil salvo.
Token. Não gera um novo e-mail.
No cabeçalho do balão, o ícone de histórico fica antes de minimizar. Busque por e-mail, use “Carregar mais 10” e selecione um perfil para consultar os mesmos dados e a aba E-mails. O histórico é compartilhado entre os consumidores deste gerador.
Instalar o balão no seu sistema
Adicione a origem do sistema (protocolo, host e porta) em ALLOWED_ORIGINS no ambiente do gerador e reimplante. No exemplo, ajuste os hosts permitidos. Execute após montar a página; chame desmontarBalao() ao sair. Em HTML, use um script type="module".
O token é digitado dentro do balão. Ative apenas em local ou homologação. O perfil permanece no balão, com cópia individual de CPF, CNPJ, empresa e endereço. A instalação funciona em todas as telas, sem configurar cada formulário. Se o sistema usa CSP, permita a origem do gerador em script-src, frame-src e connect-src.
O exemplo consulta a permissão antes de baixar o script do balão. Se o host estiver bloqueado ou a consulta falhar, o script e o balão não são carregados.
Testar o balão e a cópia manual ↗Chamar a API diretamente
Substitua SEU_TOKEN pelo token de acesso. Cada POST cria um perfil novo.
Retorno 201: { data: { id, email, profile, createdAt, support } }. Os dados de empresa ficam em profile.company.name e profile.company.cnpj; o endereço do perfil fica em profile.address. Não há endereço empresarial separado no retorno atual da origem.
Erros: { error: { code, message } }. 401: token inválido; 409: falta configurar Catch-all; 502: falha ou dados inválidos da origem; 503: banco indisponível ou tentativas esgotadas. Nenhum perfil anterior é retornado em caso de falha.
Atualizar a configuração pela API
O domínio informado aqui também determina o e-mail dos próximos perfis.
Receber e-mails dentro do balão
Configure no ambiente do EasyPanel a caixa que recebe seu Catch-all e reimplante:
IMAP_ENABLED=true IMAP_HOST=imap.seu-provedor.com IMAP_PORT=993 IMAP_SECURE=true IMAP_USER=caixa-catchall@seudominio.com.br IMAP_PASSWORD="senha-da-caixa" IMAP_MAILBOX=INBOX
A aba E-mails mostra as mensagens destinadas ao perfil atual, com rolagem própria, cópia do texto e dos códigos identificados e download de anexos. A leitura é automática enquanto o balão está aberto. O domínio dos novos perfis continua na configuração acima.
A primeira sincronização consulta as últimas 24 horas. Mensagens anteriores à criação do perfil não são associadas. O provedor precisa preservar o destinatário original no Catch-all.