Canais

A API de canais permite visualizar os canais de comunicação disponíveis na sua empresa.

Listar Canais

GET https://chat.mehub.app/api/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
status	string	Não	Filtrar por status: connected, disconnected
search	string	Não	Buscar por nome do canal

Exemplo de requisição

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

Response

{
  "success": true,
  "data": [
    {
      "token": "abc123def456ghi7",
      "name": "WhatsApp Vendas",
      "type": "whatsapp",
      "status": "connected"
    },
    {
      "token": "xyz789abc123def4",
      "name": "WhatsApp Suporte",
      "type": "whatsapp_unofficial",
      "status": "connected"
    },
    {
      "token": "mno456pqr789stu0",
      "name": "Instagram",
      "type": "instagram",
      "status": "connected"
    },
    {
      "token": "def789ghi012jkl3",
      "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
token	string	Token único 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 via conexão não oficial
instagram	Instagram Direct
messenger	Facebook Messenger
telegram	Telegram
widget	Widget de chat para websites

Uso do Token

O token 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