# Chat Pró Oratrix: API Externa — Tickets

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

</div>

# Chat Pró Oratrix: API Externa — Tickets

# 🦜 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}`.
- Cliente HTTP.

# 🧾 VISÃO GERAL

A família **Tickets** reúne operações para criar tickets, consultar informações e mensagens, adicionar ou remover tags, criar notas, atualizar fila, canal e dados do ticket, além de enviar estados de presença.

# 🧭 PASSO A PASSO GUIADO

1. Use a base `https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}`.
2. Envie `Authorization: Bearer {token}`.
3. Use JSON ou `multipart/form-data` conforme o endpoint.
4. Escolha a operação:

| Método | Endpoint | Uso |
| --- | --- | --- |
| POST | `/addTag` | Adicionar tag ao ticket |
| POST | `/addTagContact` | Adicionar tag ao contato |
| POST | `/removeTagContact` | Remover tag do contato |
| POST | `/createNotes` | Criar nota |
| POST | `/createTicket` | Criar ticket; suporta JSON, arquivo e Webmail |
| GET | `/listNotes` | Listar notas |
| POST | `/removeTag` | Remover tag do ticket |
| POST | `/sendPresence` | Enviar `typing`, `paused` ou `recording` |
| POST | `/updatequeue` | Alterar fila |
| POST | `/updatetag` | Definir tag |
| POST | `/updateticketinfo` | Atualizar dados e status do ticket |
| POST | `/showAllMessages` | Listar mensagens do ticket |
| POST | `/showallticket` | Consultar tickets pelo número |
| POST | `/showticket` | Consultar ticket pelo número |
| POST | `/showticketchatbot` | Consultar ticket no contexto de chatbot |
| POST | `/updateNote` | Atualizar nota |
| POST | `/updateTicketChannel` | Alterar canal do ticket |

## CreateTicket

O endpoint `https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}/createTicket` possui variantes documentadas para ticket comum, envio com arquivo e Webmail. Preserve campos como `body`, `number`, `externalKey`, `userId`, `status`, `channelId`, `email`, `name` e `validateNumber` conforme o formato utilizado.

## Atualização de ticket

`/updateticketinfo` aceita campos documentados como `ticketId`, `userId`, `status`, `queueId`, `typebotStatus`, `chatgptStatus`, `dialogflowStatus`, `difyStatus`, `n8nStatus` e `chatFlowId`.

# ⚠ OBSERVAÇÕES IMPORTANTES

- ⚠ Preserve endpoints, campos e valores técnicos exatamente como documentados.
- ⚠ `validateNumber=false` usa o número exatamente como enviado e é documentado como opção útil para evitar normalização do 9º dígito em determinados cenários WABA.
- ⚠ Não exponha o `{token}`.
- ⚠ `400` indica parâmetros inválidos ou ausentes; `401`, problema de autenticação/permissão.

# ⚙ DICAS E BOAS PRÁTICAS

- Gere `externalKey` único quando o endpoint exigir controle de idempotência.
- Valide IDs de ticket, fila, usuário, tag e canal antes de atualizar.
- Teste em homologação antes de automatizar ações em produção.

# 📊 RESULTADO ESPERADO

A integração poderá criar, consultar e atualizar tickets e seus elementos relacionados pela API externa.

# 🧾 RESUMO FINAL

Use as rotas da família **Tickets** a partir de `https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}` com `Authorization: Bearer {token}`.

# 🏷 KEYWORDS

API, Tickets, tags, notas, integração

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