Canais

Com a API de canais você pode visualizar os canais de comunicação disponíveis na sua empresa.

Listar Canais

GET https://api.tinko.com.br/v1/channels

Retorna todos os canais disponíveis na empresa. Retorna apenas canais que o usuário tem permissão de acesso.

Headers

Nome	Tipo	Obrigatório	Descrição
Authorization	string	Sim	Token de autenticação. Ex: `Bearer seu_token`

Query Parameters

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página. Default: `1`
per_page	integer	Não	Registros por página (máx: 100). Default: `20`
type	string	Não	Filtrar por tipo: `whatsapp`, `whatsapp_unofficial`, `instagram`, `messenger`, `telegram`, `widget`. Default: `todos`
status	string	Não	Filtrar por status: `connected`, `disconnected`. Default: `todos`
search	string	Não	Buscar por nome do canal

Exemplo de requisição

curl -X GET "https://api.tinko.com.br/v1/channels?type=whatsapp&status=connected" \
  -H "Authorization: Bearer SEU_TOKEN"

Response

{
  "success": true,
  "data": [
    {
      "id": "01arz3ndektsv4rrffq69g5fav",
      "name": "WhatsApp Vendas",
      "type": "whatsapp",
      "status": "connected"
    },
    {
      "id": "01hxyz123abc456def789ghjkm",
      "name": "WhatsApp Suporte",
      "type": "whatsapp_unofficial",
      "status": "connected"
    },
    {
      "id": "01j7m8n9p0q1r2s3t4u5v6w7x",
      "name": "Instagram",
      "type": "instagram",
      "status": "connected"
    },
    {
      "id": "01k8l9m0n1o2p3q4r5s6t7u8v9w",
      "name": "Chat do Site",
      "type": "widget",
      "status": "connected"
    }
  ],
  "pagination": {
    "total": 4,
    "per_page": 20,
    "current_page": 1,
    "last_page": 1
  }
}

Campos do Response

Campo	Tipo	Descrição
id	string	ID do canal
name	string	Nome do canal
type	string	Tipo do canal
status	string	Status: `connected`, `disconnected`

Tipos de Canal

Tipo	Descrição
whatsapp	WhatsApp Business API (oficial)
whatsapp_unofficial	WhatsApp conectado via API
instagram	Instagram Direct
messenger	Facebook Messenger
telegram	Telegram
widget	Widget de chat para websites

Uso do ID

O ID do canal é utilizado em diversas operações:

Enviar mensagens: especificando o canal de origem no campo channel
Transferir conversas: direcionando para outro canal
Vincular usuários: dando acesso a canais específicos
Listar templates: filtrando templates por canal