# Chat Pró Oratrix: API Externa — Interativo Instagram

**URL:** https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-api-externa-interativo-instagram/379
**Category:** Chatbot Pró da Oratrix
**Tags:** instagram, chat-pro-oratrix, api, interativo
**Created:** [Setembro 20, 2026, 7:33pm UTC](https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-api-externa-interativo-instagram/379 "2026-09-20T19:33:58Z")
**Posts on this page:** 1
**Page:** 1

<div class="post-metadata">

### Author: ![Oratrix.Tecnologias](https://ajuda.oratrixtelecom.com.br/user_avatar/ajuda.oratrixtelecom.com.br/oratrix.tecnologias/32/346_2.png) [@Oratrix.Tecnologias](https://ajuda.oratrixtelecom.com.br/u/Oratrix.Tecnologias)
#### Post date: [Setembro 20, 2026, 7:33pm UTC](https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-api-externa-interativo-instagram/379/1 "2026-09-20T19:33:58Z")

</div>

# Chat Pró Oratrix: API Externa — Interativo Instagram

# 🦜 SERVIÇO

**Serviço:** Chat Pró Oratrix

# 🛠 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.

# 🧾 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.

# 🧭 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`.

# ⚠ OBSERVAÇÕES IMPORTANTES

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

# ⚙ 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.

# 📊 RESULTADO ESPERADO

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

# 🧾 RESUMO FINAL

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

# 🏷 KEYWORDS

API, Instagram, interativo, Ice Breakers, menu

### 🤖 **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.

> **[ChatGPT - I.A. Assistente da Oratrix](https://chatgpt.com/g/g-68790cabbfa48191a8de20c4ffed7b92-i-a-assistente-da-oratrix)**
>
> IA para tirar dúvidas sobre os serviços da Oratrix: PABX Virtual, Chip 4G/5G, Chatbot, Telefonia Fixa, Portabilidade, Afiliados e mais. ⚠️ As respostas servem apenas como consulta e não garantem preços, prazos ou condições comerciais, pois esta IA...