Skip to main content
Um canal representa um número WhatsApp conectado ao Coexy. Após criar um canal, compartilhe o connect_url para que o responsável pelo número faça a conexão via WhatsApp Embedded Signup.

Tipo Channel

Status do canal

Tokens são gerenciados automaticamente pelo Coexy. Após conectar o WhatsApp, você não precisa se preocupar com renovação de tokens — o Coexy cuida disso. Em casos raros (ex: revogação de permissão na Meta), o canal muda para disconnected e você deve reconectar pelo connect_url.

Fluxo de conexão

  1. Crie o canal via POST /channels — ele nasce com status pending
  2. Compartilhe o connect_url com o dono do número WhatsApp
  3. O dono acessa o link e autoriza via WhatsApp Embedded Signup
  4. O canal muda para active e os campos phone_number_id, waba_id e display_phone_number são preenchidos
phone_number_id e waba_id só ficam disponíveis após a conexão. Antes disso, são null.

Endpoints

Listar canais

string
required
Sua API Key
Resposta: Channel[]

Criar canal

string
required
Nome identificador do canal
Resposta: Channel — status 201 Created Após criar, compartilhe o connect_url retornado para que o número seja conectado.

Buscar canal

Resposta: Channel

Deletar canal

boolean
Obrigatório se o canal está com status: active. Use ?force=true para confirmar.
Resposta: 204 No Content

Erros