# Chat Pró Oratrix: API Externa — CRM Pipeline

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

</div>

# Chat Pró Oratrix: API Externa — CRM Pipeline

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

# 🧾 VISÃO GERAL

A família **CRM Pipeline** permite criar, listar, consultar, atualizar e excluir pipelines e etapas (`stages`) pela API externa.

# 🧭 PASSO A PASSO GUIADO

1. Use `https://api-pro1.oratrixchat.com.br/v2/api/external/{ApiID}`.
2. Envie `Authorization: Bearer {token}`.
3. Use as rotas abaixo:

| Método | Endpoint | Finalidade |
| --- | --- | --- |
| POST | `/pipeline/create` | Criar pipeline |
| POST | `/pipeline/delete/{id}` | Excluir pipeline |
| GET | `/pipeline/list` | Listar pipelines |
| GET | `/pipeline/show/{id}` | Consultar pipeline |
| POST | `/pipeline/update/{id}` | Atualizar pipeline |
| POST | `/stage/create` | Criar etapa |
| POST | `/stage/delete/{id}` | Excluir etapa |
| GET | `/stage/list` | Listar etapas |
| GET | `/stage/show/{id}` | Consultar etapa |
| POST | `/stage/update/{id}` | Atualizar etapa |

## Campos documentados

- `/pipeline/create`: `name`, `description`.
- `/pipeline/update/{id}`: `name`.
- `/stage/create`: `name`, `pipelineId`, `order`, `color`.
- `/stage/list`: aceita `page`, `limit` e `pipelineId`.
- `/stage/update/{id}`: `name`.

# ⚠ OBSERVAÇÕES IMPORTANTES

- ⚠ Preserve os nomes `pipeline` e `stage` nos endpoints.
- ⚠ Confirme o `id` antes de atualizar ou excluir.
- ⚠ 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

- Liste o pipeline antes de alterar suas etapas.
- Defina `order` e `color` de forma consistente ao criar stages.
- Teste exclusões em ambiente controlado.

# 📊 RESULTADO ESPERADO

A integração poderá administrar pipelines e etapas do CRM via API externa.

# 🧾 RESUMO FINAL

Use as rotas `/pipeline/*` e `/stage/*` a partir da URL base oficial com `Authorization: Bearer {token}`.

# 🏷 KEYWORDS

API, CRM, Pipeline, Stage, 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...
