# Chat Pró Oratrix: API Externa — Mensagens

**URL:** https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-api-externa-mensagens/377
**Category:** Chatbot Pró da Oratrix
**Tags:** chat-pro-oratrix, mensagens, integracao, api
**Created:** [Setembro 20, 2026, 7:33pm UTC](https://ajuda.oratrixtelecom.com.br/t/chat-pro-oratrix-api-externa-mensagens/377 "2026-09-20T19:33:25Z")
**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-mensagens/377/1 "2026-09-20T19:33:25Z")

</div>

# Chat Pró Oratrix: API Externa — Mensagens

# 🦜 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}`.
- Número do destinatário e conteúdo da mensagem conforme a rota utilizada.

# 🧾 VISÃO GERAL

A família **Mensagens** permite consultar uma mensagem por `messageId` e enviar texto, arquivo, mídia por URL, conteúdo em Base64 ou áudio pela API externa.

# 🧭 PASSO A PASSO GUIADO

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

| Método | Endpoint | Finalidade |
| --- | --- | --- |
| GET | `/getMessageByMessageId` | Consultar mensagem por `messageId` |
| POST | `/v2/api/external/{ApiID}` | Enviar texto ou arquivo |
| POST | `/url` | Enviar arquivo por URL |
| POST | `/base64` | Enviar arquivo em Base64 |
| POST | `/voice` | Enviar áudio por URL |
| GET | `/params/` | Enviar por parâmetros de query conforme coleção documentada |

## Campos principais

No envio padrão, a documentação apresenta `body`, `number`, `externalKey`, `isClosed` e `validateNumber`; no formato multipart, o arquivo vai em `media`.

`/url` utiliza `mediaUrl`, `body`, `number`, `externalKey`, `isClosed` e `validateNumber`.

`/base64` utiliza `body`, `number`, `base64Data`, `mimeType`, `fileName`, `isClosed` e `validateNumber`.

`/voice` utiliza `audio`, `number`, `externalKey` e `isClosed`.

`/getMessageByMessageId` recebe `messageId` em query, incluindo IDs retornados pela Meta como `wamid.xxxxx`.

# ⚠ OBSERVAÇÕES IMPORTANTES

- ⚠ Preserve exatamente os nomes técnicos dos campos e endpoints.
- ⚠ `externalKey` deve ser único quando utilizado para controle do envio.
- ⚠ `validateNumber=false` usa o número exatamente como enviado, sem normalização do 9º dígito brasileiro.
- ⚠ A rota `/params/` documenta `bearertoken` como parâmetro de query; preserve esse comportamento somente quando utilizar essa rota específica.
- ⚠ Não exponha `{token}` em logs públicos ou capturas de tela.

# ⚙ DICAS E BOAS PRÁTICAS

- Use o endpoint adequado ao tipo de mídia.
- Confirme `mimeType` e `fileName` em envios Base64.
- Teste texto e mídia separadamente antes de automatizar.

# 📊 RESULTADO ESPERADO

A integração poderá consultar mensagens e enviar diferentes tipos de conteúdo pela API externa.

# 🧾 RESUMO FINAL

Use a URL base oficial `https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}` com `Authorization: Bearer {token}` e as rotas específicas para cada tipo de conteúdo.

# 🏷 KEYWORDS

API, mensagens, mídia, Base64, WhatsApp

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