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	multipart/form-data
X-Api-Key	Token de acesso da API

Corpo da requisição (multipart/form-data)

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).
anexo	arquivo	não	Arquivo a ser anexado ao e-mail (ex: um PDF). Enviado como parte do arquivo (file part) do multipart, não como texto.

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 "X-Api-Key: SEU_TOKEN_AQUI" \
  -F "paraEmail=cliente@exemplo.com.br" \
  -F "paraNome=Cliente Exemplo" \
  -F "assunto=Assunto do e-mail" \
  -F "texto=Corpo da mensagem." \
  -F "anexo=@/caminho/para/arquivo.pdf;type=application/pdf"

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.