API para envio de e-mails da Papaiz, usada por sistemas internos (ex: GeneXus). Reproduz a lógica do programa original EnviaEmailProducaoPapaiz, agora como um endpoint HTTP.

Endpoint

POST /api/email/enviar

Autenticação

Toda requisição precisa do header X-Api-Key com o token de acesso da API. Sem esse header (ou com valor incorreto), a API responde 401 Unauthorized. O token é gerenciado internamente pela equipe da Papaiz/Tórus Tecnologia — solicite o valor a quem administra o ambiente.

Cabeçalhos da requisição

Header	Valor
Content-Type	application/json
X-Api-Key	Token de acesso da API

Corpo da requisição (JSON)

Campo	Tipo	Obrigatório	Descrição
paraEmail	string	sim	E-mail do destinatário.
paraNome	string	não	Nome do destinatário (usado como nome de exibição).
assunto	string	sim	Assunto do e-mail.
texto	string	sim	Corpo do e-mail (texto simples).
anexoNomeArquivo	string	não	Nome do arquivo do anexo (ex: nota.pdf). Só é usado se anexoBase64 for informado.
anexoBase64	string	não	Conteúdo do anexo, codificado em base64.

O e-mail é sempre enviado como Papaiz Associados, usando o servidor SMTP e a conta cadastrados internamente para a empresa — não é possível (nem necessário) informar isso na requisição.

Exemplo de requisição

curl -X POST https://papaizenvioemails.agendandofacil.com.br/api/email/enviar \
  -H "Content-Type: application/json" \
  -H "X-Api-Key: SEU_TOKEN_AQUI" \
  -d '{
    "paraEmail": "cliente@exemplo.com.br",
    "paraNome": "Cliente Exemplo",
    "assunto": "Assunto do e-mail",
    "texto": "Corpo da mensagem."
  }'

Resposta

Em caso de sucesso (200 OK):

{ "sucesso": true, "mensagem": "Enviado com sucesso" }

Em caso de falha ao enviar (500):

{ "sucesso": false, "mensagem": "<detalhe do erro de envio>" }

Códigos de retorno

Código	Significado
200	E-mail enviado com sucesso.
400	Campo obrigatório ausente no corpo da requisição.
401	Header X-Api-Key ausente ou inválido.
500	Falha ao conectar/autenticar/enviar pelo servidor SMTP, ou configuração da empresa não encontrada.