Chat Pró Oratrix: API Externa — Interativo Instagram

Chatbot Pró da Oratrix
, , ,
1

Chat Pró Oratrix: API Externa — Interativo Instagram

:parrot: SERVIÇO

Serviço: Chat Pró Oratrix

:hammer_and_wrench: VOCÊ VAI PRECISAR

  • URL base: https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}.
  • Token de autenticação {token}.
  • ticketId válido quando a operação for vinculada a um atendimento.

:receipt: VISÃO GERAL

A família Interativo Instagram permite enviar respostas rápidas, botões e cards no Instagram, além de consultar, configurar ou remover Ice Breakers e o menu persistente.

:compass: PASSO A PASSO GUIADO

Use https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID} com Authorization: Bearer {token}.

Método Endpoint Finalidade
POST /sendInteractive/instagram/quickReply Quick Reply
POST /sendInteractive/instagram/buttonTemplate Template com botões
POST /sendInteractive/instagram/genericTemplate Cards genéricos
POST /instagram/iceBreakers Consultar, configurar ou remover Ice Breakers
POST /instagram/persistentMenu Consultar, configurar ou remover menu persistente

Campos principais

  • Quick Reply: ticketId, message, quickReplies.
  • Button Template: ticketId, message, buttons.
  • Generic Template: ticketId, elements.
  • Ice Breakers: action, iceBreakers; cada item pode usar question e payload.
  • Persistent Menu: action, composerInputDisabled, menuItems; cada item pode usar type, title e payload.

:warning: OBSERVAÇÕES IMPORTANTES

  • :warning: Preserve exatamente os nomes técnicos e estruturas dos arrays.
  • :warning: Confirme o ticketId antes de enviar conteúdo interativo.
  • :warning: Não exponha o {token}.
  • :warning: 400 indica parâmetros inválidos ou ausentes; 401, falha de autenticação/permissão.

:gear: DICAS E BOAS PRÁTICAS

  • Teste Quick Reply, botões e cards separadamente.
  • Revise action antes de alterar Ice Breakers ou menu persistente.
  • Valide títulos, payloads e URLs usados nos cards.

:bar_chart: RESULTADO ESPERADO

A integração poderá enviar conteúdos interativos e administrar recursos de entrada do Instagram pela API externa.

:receipt: RESUMO FINAL

Use as rotas /sendInteractive/instagram/* e /instagram/* com a URL base oficial e Authorization: Bearer {token}.

:label: KEYWORDS

API, Instagram, interativo, Ice Breakers, menu

:robot: Peça ajuda ao ChatGPT da Oratrix

A I.A. da Oratrix no ChatGPT poderá tirar dúvidas e te guiar passo a passo no suporte.