Pular para o conteúdo
Contatos

Enviar e-mail ao contato

v1.0.0
POSThttps://api.growthaisystem.com/api/v1/contacts/{id}/emails
  • ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposcontacts.writeemails.send

Manda um e-mail de texto ao contato, no endereço do CADASTRO dele (o corpo nunca escolhe o destinatário). Sai do domínio verificado do negócio (auto@<domínio>, com o nome do negócio como remetente e o e-mail do dono como resposta), com rodapé de identificação e descadastro de um clique. Sem domínio verificado, nada sai (422 email_not_configured).

Escopos: contacts.write e emails.send. Use `Idempotency-Key`: o retry com a mesma chave não manda de novo.

Funcionário digital: o pedido fica SEMPRE para o dono aprovar (202, acompanhe em GET /actions/{id}); na aprovação as mesmas regras são conferidas de novo e, se algo mudou, nada sai.

Parâmetros de caminho

Entram no próprio endereço, no lugar das chaves.

  • idstringobrigatório
    • tamanho 1–80

Corpo da requisição

application/jsonobrigatório

V1ContactEmailInputInput

  • subjectstringobrigatório
    • tamanho 1–200
  • textstringobrigatório
    • tamanho 1–10000

Respostas

12 respostas documentadas — o código, o que ele significa nesta rota e a forma do corpo.

200Deu certoapplication/json

A Idempotency-Key repetiu um envio anterior: o mesmo registro, com idempotency_replay: true. Nada saiu de novo.

V1ContactEmailSent

  • idstring
  • contactIdstring
  • tostring
  • subjectstring
  • sentAtstring
  • idempotency_replaytruepode faltar
    • sempre true