Provedores de Despacho

GET /api/dispatch-providers

Lista todos os provedores de despacho globais com suas definições de canal.

Auth: Obrigatória — permissão activity:view

Resposta `200 OK`

[
  {
    "id": "660e8400-e29b-41d4-a716-446655440000",
    "code": "YOM",
    "name": "YOM Provider",
    "protocolType": "REST",
    "isActive": true,
    "channelDefinitions": [
      {
        "channel": "SALESMAN",
        "credentialSchema": [
          {
            "key": "apiKey",
            "label": "API Key",
            "type": "password",
            "required": true
          }
        ],
        "settingsSchema": []
      }
    ]
  }
]

GET /api/dispatch-providers/:id/channel-definitions

Lista as definições de canal de um provedor de despacho específico.

Auth: Obrigatória — permissão activity:view

Parâmetros de Rota

Parâmetro	Tipo	Descrição
`id`	UUID	ID do provedor de despacho

Exemplo

curl https://api.reten.ai/api/dispatch-providers/660e8400-e29b-41d4-a716-446655440000/channel-definitions \
  -H "Authorization: Bearer <token>"

const providerId = "660e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/dispatch-providers/${providerId}/channel-definitions`, {
  headers: { "Authorization": "Bearer <token>" },
});
const definitions = await response.json();

import requests

provider_id = "660e8400-e29b-41d4-a716-446655440000"
response = requests.get(
    f"https://api.reten.ai/api/dispatch-providers/{provider_id}/channel-definitions",
    headers={"Authorization": "Bearer <token>"},
)
definitions = response.json()

Resposta `200 OK`

[
  {
    "id": "770e8400-e29b-41d4-a716-446655440000",
    "dispatchProviderId": "660e8400-e29b-41d4-a716-446655440000",
    "channel": "SALESMAN",
    "credentialSchema": [
      {
        "key": "apiKey",
        "label": "API Key",
        "type": "password",
        "required": true
      }
    ],
    "settingsSchema": [],
    "createdAt": "2025-01-15T10:00:00.000Z",
    "updatedAt": "2025-01-15T10:00:00.000Z"
  }
]

Respostas de Erro

Status	Descrição
`404`	Provedor de despacho não encontrado

POST /api/dispatch-providers

Cria um novo provedor de despacho global.

Auth: Obrigatória — permissão activity-config:manage

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`code`	string	Sim	Código único do provedor
`name`	string	Sim	Nome do provedor
`protocol_type`	string	Sim	`REST`, `WEBHOOK`, `EMAIL`, `SMS` ou `WSP`

Resposta `201 Created`

PATCH /api/dispatch-providers/:id

Atualiza um provedor de despacho.

Auth: Obrigatória — permissão activity-config:manage

Corpo da Requisição

Campo	Tipo	Obrigatório	Descrição
`name`	string	Não	Nome do provedor
`protocol_type`	string	Não	Tipo de protocolo
`is_active`	boolean	Não	Status ativo