For the complete documentation index, see llms.txt. This page is also available as Markdown.

💬 Interativo Messenger

Quick Reply

post
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
ticketIdintegerOpcionalExample: 123
messagestringOpcionalExample: Escolha:
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/sendInteractive/messenger/quickReply
POST /v2/api/external/{apiId}/sendInteractive/messenger/quickReply HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 162

{
  "ticketId": 123,
  "message": "Escolha:",
  "quickReplies": [
    {
      "content_type": "text",
      "title": "Sim",
      "payload": "YES"
    },
    {
      "content_type": "text",
      "title": "Não",
      "payload": "NO"
    }
  ]
}
{}

Button Template

post
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
ticketIdintegerOpcionalExample: 123
messagestringOpcionalExample: Opções:
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/sendInteractive/messenger/buttonTemplate
POST /v2/api/external/{apiId}/sendInteractive/messenger/buttonTemplate HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 165

{
  "ticketId": 123,
  "message": "Opções:",
  "buttons": [
    {
      "type": "postback",
      "title": "Opção 1",
      "payload": "OPT_1"
    },
    {
      "type": "web_url",
      "title": "Visitar",
      "url": "https://..."
    }
  ]
}
{}

Generic Template (cards)

post
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
ticketIdintegerOpcionalExample: 123
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/sendInteractive/messenger/genericTemplate
POST /v2/api/external/{apiId}/sendInteractive/messenger/genericTemplate HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 163

{
  "ticketId": 123,
  "elements": [
    {
      "title": "Card 1",
      "subtitle": "Subtítulo",
      "image_url": "https://...",
      "buttons": [
        {
          "type": "postback",
          "title": "Ação",
          "payload": "ACT"
        }
      ]
    }
  ]
}
{}

Media Template (image/video + botões)

post
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
ticketIdintegerOpcionalExample: 123
mediaTypestringOpcionalExample: image
mediaUrlstringOpcional

exemplo.com/imagem.jpg",

Example: https://exemplo.com/imagem.jpg
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/sendInteractive/messenger/mediaTemplate
POST /v2/api/external/{apiId}/sendInteractive/messenger/mediaTemplate HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 146

{
  "ticketId": 123,
  "mediaType": "image",
  "mediaUrl": "https://exemplo.com/imagem.jpg",
  "buttons": [
    {
      "type": "postback",
      "title": "Comprar",
      "payload": "BUY"
    }
  ]
}
{}

Receipt Template (recibo)

post
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
ticketIdintegerOpcionalExample: 123
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/sendInteractive/messenger/receiptTemplate
POST /v2/api/external/{apiId}/sendInteractive/messenger/receiptTemplate HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 259

{
  "ticketId": 123,
  "receipt": {
    "recipient_name": "João Silva",
    "order_number": "ORD-001",
    "currency": "BRL",
    "payment_method": "PIX",
    "summary": {
      "total_cost": 150
    },
    "elements": [
      {
        "title": "Produto A",
        "price": 100,
        "quantity": 1
      },
      {
        "title": "Produto B",
        "price": 50,
        "quantity": 1
      }
    ]
  }
}
{}

Message Tag (Marketing/Utility)

post
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
ticketIdintegerOpcionalExample: 123
messagestringOpcionalExample: Seu pedido foi aprovado.
tagstringOpcionalExample: POST_PURCHASE_UPDATE
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/sendInteractive/messenger/messageTag
POST /v2/api/external/{apiId}/sendInteractive/messenger/messageTag HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 82

{
  "ticketId": 123,
  "message": "Seu pedido foi aprovado.",
  "tag": "POST_PURCHASE_UPDATE"
}
{}

Customer Feedback Template (NPS/CSAT)

post
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
ticketIdintegerOpcionalExample: 123
titlestringOpcionalExample: Avalie sua experiência
subtitlestringOpcionalExample: Opcional
business_privacy_urlstringOpcional

exemplo.com/privacidade",

Example: https://exemplo.com/privacidade
expires_in_daysintegerOpcionalExample: 7
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/sendInteractive/messenger/customerFeedback
POST /v2/api/external/{apiId}/sendInteractive/messenger/customerFeedback HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 252

{
  "ticketId": 123,
  "title": "Avalie sua experiência",
  "subtitle": "Opcional",
  "business_privacy_url": "https://exemplo.com/privacidade",
  "expires_in_days": 7,
  "feedback_screens": [
    {
      "questions": [
        {
          "id": "CSAT",
          "type": "csat",
          "title": "Como foi nosso atendimento?"
        }
      ]
    }
  ]
}
{}

Greeting Text (get/set/delete)

post
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
actionstringOpcionalExample: set
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/messenger/greeting
POST /v2/api/external/{apiId}/messenger/greeting HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 87

{
  "action": "set",
  "greetings": [
    {
      "locale": "default",
      "text": "Olá! Como podemos ajudar?"
    }
  ]
}
{}

Personas (list/create/delete)

post
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
actionstringOpcionalExample: create
namestringOpcionalExample: Atendente Ana
profilePictureUrlstringOpcional

exemplo.com/ana.jpg"

Example: https://exemplo.com/ana.jpg
Respostas
200

Requisição processada com sucesso.

application/json
objectOpcional
post/v2/api/external/{apiId}/messenger/personas
POST /v2/api/external/{apiId}/messenger/personas HTTP/1.1
Host: api.seudominio.com.br
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 92

{
  "action": "create",
  "name": "Atendente Ana",
  "profilePictureUrl": "https://exemplo.com/ana.jpg"
}
{}

Atualizado

Isto foi útil?