🎯 Envio Por Ticket

SendMessageByTicket

post

Endpoint com mais de um formato de payload na coleção oficial: SendMessageByTicketText, SendMessageByTicketFile, SendMessageByTicketMediaUrl, SendMessageByTicketBase64. Veja os exemplos do corpo para escolher a variante.

Autorizações

AuthorizationstringObrigatório

Token da API do tenant (na coleção Postman: BearerToken).

Parâmetros de rota

apiIdstringObrigatório

ID da API externa cadastrada no Z-PRO.

Corpo

ticketIdintegerOpcional

ID do ticket (conversa) que recebera a mensagem

Example: 1262

bodystringObrigatório

Texto da mensagem (obrigatorio quando nao ha midia)

Example: Ola! Como posso ajudar?

externalKeystringOpcional

Chave unica p/ idempotencia (recomendado)

Example: chave-001

reopenbooleanOpcional

Reabrir ticket fechado antes de enviar (sem isto, ticket fechado retorna 409)

Example: false

isClosedbooleanOpcional

Fechar o ticket apos o envio

Example: false

Respostas

200

Requisição processada com sucesso.

application/json

objectOpcional

400

Parâmetros inválidos ou faltando.

401

Token ausente, inválido ou sem permissão.

post/v2/api/external/{apiId}/sendMessageByTicket

POST /v2/api/external/{apiId}/sendMessageByTicket HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "ticketId": 1262,
  "body": "Ola! Como posso ajudar?",
  "externalKey": "chave-001",
  "reopen": false,
  "isClosed": false
}

{}