Reenviar a apresentação comercial ao contato

v1.0.0

POSThttps://api.staging.growthaisystem.com/api/v1/contacts/{id}/presentations/send

ExigeAuthorization: Bearer gos_…— Chave de API (gos_…)· escoposcontacts.writepresentations.send

Depende da aprovação do dono. Esta rota só funciona para o funcionário digital com a aprovação de escritas ligada, e cada envio espera o ok do dono. Chave de integração comum ou token OAuth: 403 presentation_requires_approval. Funcionário digital com a aprovação desligada: 403 autonomy_forbidden.

Manda ao contato a apresentação comercial (o PDF que o Deal Advisor gerou da call, já anexado ao contato) pelo e-mail ou pelo WhatsApp, como o botão "Enviar" da ficha do contato. Vai a versão mais recente do contato (ou do negócio, com opportunityId). Gerar uma apresentação nova depende da call gravada no desktop e não existe pela API.

Quem APROVA é quem envia (o remetente do e-mail, as permissões dele no CRM e no Atendimento).

Escopos: contacts.write e presentations.send.

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

V1ContactPresentationSendInputInput

channelstringobrigatório
- um de"email""whatsapp"
opportunityIdstringopcional
- tamanho 1–80

Respostas

13 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, com idempotency_replay: true. Nada saiu de novo.

V1ContactPresentationSent

contactIdstring
presentationIdstring
versioninteger
fileNamestring
channelstring
- um de"email""whatsapp"
tostring
emailModestring | null
- um de"anexo""link"
sentAtstring
idempotency_replaytruepode faltar
- sempre true

Definição

POST/contacts/{id}/presentations/send

Exemplo

https://api.staging.growthaisystem.com/api/v1/contacts/SEU_ID_AQUI/presentations/send

Requisição

curl -X POST "https://api.staging.growthaisystem.com/api/v1/contacts/SEU_ID_AQUI/presentations/send" \
  -H "Authorization: Bearer gos_SEU_TOKEN_AQUI"

Isto chama a API de verdade. A requisição sai do seu navegador direto para https://api.staging.growthaisystem.com — dado real, do workspace da chave que você colar. Em escritas, o efeito é permanente.

Chave de APIBearerobrigatório

Vai no cabeçalho Authorization: Bearer …. Ela nunca aparece no cURL copiável nem sai desta aba.

Lembrar nesta aba — some ao fechá-la. Não marque em computador compartilhado: a chave dá acesso ao workspace inteiro dentro dos escopos dela.

Parâmetros de caminho

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

idtextoobrigatório

Corpoapplication/jsonobrigatório

JSON válido· 1 linha

O exemplo vem do próprio schema da API. Troque os valores pelos seus antes de enviar.

Vai sair assim

POSThttps://api.staging.growthaisystem.com/api/v1/contacts/{id}/presentations/send

O botão copia o cURL equivalente — com gos_SEU_TOKEN_AQUI no lugar da sua chave.

⌘Enter

Resposta

{
  "contactId": "<texto>",
  "presentationId": "<texto>",
  "version": 0,
  "fileName": "<texto>",
  "channel": "email",
  "to": "<texto>",
  "emailMode": "anexo",
  "sentAt": "<texto>",
  "idempotency_replay": true
}