Wow! Redução de 65% no preço para clientes brasileiros! Registre-se agora
Guia da API de Canais do WhatsApp

Como gerenciar e automatizar canais do WhatsApp via API

Atualizado em 5 de agosto de 2026

Este guia técnico da Whapi.Cloud explica como gerenciar e automatizar de forma programática os canais do WhatsApp (newsletters) via API REST. Embora a API oficial da Meta (WABA) careça totalmente de endpoints para canais de transmissão, o gateway de sockets de sessão web da Whapi.Cloud fornece as ferramentas de desenvolvimento e os fluxos de trabalho sem código (Make, n8n, Zapier) necessários para automatizar a criação de canais, o onboarding de assinantes e as postagens interativas sem atrasos de infraestrutura.

Manage WhatsApp channels easily via API
TL;DR: A API oficial da Meta WABA não oferece suporte a canais de transmissão. Para transmissão automatizada, conecte seu número via gateway de sockets de sessão web da Whapi.Cloud em menos de 2 minutos. Use o endpoint POST /newsletters para criar canais programaticamente e associe payloads JSON dinâmicos no n8n ou Make para automatizar a postagem cruzada sem taxas por mensagem.

Por que a API oficial da Meta (WABA) falha para os canais do WhatsApp

A API oficial do WhatsApp Business da Meta oferece zero recursos para canais de transmissão. Não existem endpoints para criar canais, publicar atualizações ou gerenciar assinantes no ambiente oficial da API da Meta.
Se você deseja automatizar newsletters, enviar transmissões de notícias ou criar canais programáticos, as credenciais oficiais não funcionarão. A Whapi.Cloud fornece acesso direto e completo à API REST de canais do WhatsApp vinculando qualquer número de telefone padrão por meio de um protocolo de sessão web de forma estável.
Recurso / Capacidade Meta WABA Oficial (Cloud API) Gateway de API de canais da Whapi.Cloud
Canais do WhatsApp (Newsletters) Não compatível (0% de funcionalidade) Acesso completo via API REST
Modelo de preços de mensagens Taxas de conversação variáveis da Meta + taxas adicionais do BSP Assinatura mensal fixa (mensagens ilimitados)
Onboarding e verificação Verificação complexa de Facebook Business (dias/semanas) Escaneamento instantâneo de código QR (menos de 2 minutos)
Modelos de mensagens e HSM Aprovação prévia obrigatória para todas as transmissões Nenhum modelo é necessário; envie qualquer conteúdo livremente
Canais interativos (Quizzes/Perguntas) Não compatível Enquetes nativas, quizzes e cartões de perguntas e respostas programáticos

Como conectar seu WhatsApp e começar a usar a API

Antes de criar canais ou enviar transmissões, você precisa conectar seu número de WhatsApp à Whapi.Cloud para obter um token de API.
Crie uma conta gratuita no painel de controle da Whapi.Cloud. Você não precisa de um cartão de crédito para começar, e um canal de teste gratuito estará pronto para você imediatamente.
Escaneie o código QR com seu telefone. Isso conecta seu número de WhatsApp por meio de sockets estáveis de sessão web, semelhante a vincular o WhatsApp Web, mas executando com segurança em nossos servidores.
Criar uma conta
Como conectar seu dispositivo:
  1. 1) Vá para o painel de controle da Whapi.Cloud e localize seu canal padrão.
  2. 2) Abra o WhatsApp em seu dispositivo móvel.
  3. 3) Vá em Configurações -> Aparelhos conectados -> Conectar um aparelho.
  4. 4) Escaneie o código QR exibido na tela.
Seu token de API seguro único será exibido no centro da página do canal conectado.
Este token é essencial para autenticar solicitações de API; ele deve ser incluído nos cabeçalhos das solicitações como um token Bearer ou passado como um parâmetro, dependendo do método.
open WhatsApp on your mobile device, go to Settings -> Connected devices
Vão para Aparelhos conectados nas configurações do WhatsApp
Scan the QR code in your WhatsApp
Scan the QR code with your device
Whatsapp API start working
A conexão do WhatsApp foi estabelecida com sucesso
Get WhatsApp API Key
Copie seu token de API seguro da Whapi.Cloud
Vamos explorar as principais solicitações da API para gerenciar canais de forma programática.
Central de Ajuda e Guia

Como automatizar canais do WhatsApp via API REST

Para criar um canal de WhatsApp totalmente novo de forma programática, envie uma solicitação POST para o endpoint /newsletters. Isso é ideal para plataformas, SaaS ou redes multicanais que precisam provisionar ambientes de transmissão separados para diferentes criadores ou filiais de forma automática.
No payload da sua solicitação, forneça o name (nome) do canal e uma descrição opcional description. Você também pode carregar uma imagem de perfil no parâmetro newsletter_pic. A API retorna um newsletter_id exclusivo no formato 120363..._example@newsletter, que você usará para todas as transmissões futuras.
curl --request POST \
     --url https://gate.whapi.cloud/newsletters \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "name": "Developer Channel",
  "description": "Tech newsletters & API updates"
}
'
<?php
// composer require guzzlehttp/guzzle
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/newsletters', [
  'body' => '{"name":"Developer Channel","description":"Tech newsletters & API updates"}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();
# python -m pip install requests
import requests

url = "https://gate.whapi.cloud/newsletters"

payload = {
    "name": "Developer Channel",
    "description": "Tech newsletters & API updates"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
// POST https://gate.whapi.cloud/newsletters
// Programmatic creation of a brand new broadcast channel on WhatsApp
const createNewsletter = async (channelName, channelDescription) => {
  // if you omit the 'name' parameter, gate.whapi.cloud returns a 400 schema validation error
  const response = await fetch('https://gate.whapi.cloud/newsletters', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      name: channelName,
      description: channelDescription,
      newsletter_pic: "https://whapi.cloud/assets/img/whapi/logo-text.svg"
    })
  });

  if (!response.ok) {
    throw new Error(`API Error: ${response.status} ${await response.text()}`);
  }

  const data = await response.json();
  console.log(`Channel Created Successfully. NewsletterID: ${data.id}`);
  return data.id; // Returns format: newsletter_id_example@newsletter
};
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"name\":\"Developer Channel\",\"description\":\"Tech newsletters & API updates\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/newsletters")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
// dotnet add package RestSharp
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/newsletters");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
request.AddJsonBody("{\"name\":\"Developer Channel\",\"description\":\"Tech newsletters & API updates\"}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

Como enviar postagens para canais do WhatsApp via API

Para publicar mensagens ou atualizações de mídia em um canal do WhatsApp, seu sistema deve enviar solicitações ao JID do canal correspondente. Se você não souber o ID do canal (JID), use o endpoint GET /newsletters para recuperar uma lista de todos os canais vinculados à sua conta.
O ID do canal seguirá o formato padrão: 120363171744447809@newsletter. Uma vez que você tenha esse identificador exclusivo, enviar uma mensagem é tão simples quanto iniciar uma solicitação POST.
Use o endpoint POST /messages/text, passando o JID do canal no parâmetro to e o texto sem formatação no parâmetro body. Isso permite transmitir anúncios, links ou alertas de forma programática para toda a sua base de assinantes instantaneamente.
curl --request POST \
     --url https://gate.whapi.cloud/messages/text \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "120363171744447809@newsletter",
  "body": "Hello subscribers, this is an automated update!"
}
'
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/messages/text', [
  'body' => '{"to":"120363171744447809@newsletter","body":"Hello subscribers, this is an automated update!"}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();
import requests

url = "https://gate.whapi.cloud/messages/text"

payload = {
    "to": "120363171744447809@newsletter",
    "body": "Hello subscribers, this is an automated update!"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
// POST https://gate.whapi.cloud/messages/text
// Send a text message post to a public WhatsApp Channel
const sendPostToChannel = async (newsletterId, postContent) => {
  // Pass your channel ID in the "to" parameter (format: 120363...@newsletter)
  const response = await fetch('https://gate.whapi.cloud/messages/text', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: newsletterId,
      body: postContent
    })
  });

  if (!response.ok) {
    throw new Error(`Failed to send post: ${response.status} ${await response.text()}`);
  }

  const data = await response.json();
  console.log(`Post sent successfully! Message ID: ${data.message.id}`);
  return data.message.id;
};
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\":\"120363171744447809@newsletter\",\"body\":\"Hello subscribers, this is an automated update!\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/messages/text")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/messages/text");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
request.AddJsonBody("{\"to\":\"120363171744447809@newsletter\",\"body\":\"Hello subscribers, this is an automated update!\"}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);
Central de Ajuda e Guia

Como inscrever sua sessão ou bot em um canal do WhatsApp

O endpoint POST /newsletters/{NewsletterID}/subscription foi projetado para inscrever seu próprio número do WhatsApp conectado em qualquer canal de destino. Isso é extremamente útil para criar scrapers, analisadores ou rastreadores de conteúdo que precisam seguir automaticamente canais de notícias, feeds de concorrentes ou tópicos de anúncios.
Para segurança e validação da API, certifique-se de passar o newsletter_id completo (incluindo o sufixo @newsletter) no caminho da URL. Uma vez inscrita, sua sessão de bot receberá todas as mensagens e mídias recém-publicadas em tempo real via webhooks.
curl --request POST \
     --url https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/subscription \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN'
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/subscription', [
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
  ],
]);

echo $response->getBody();
import requests

url = "https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/subscription"

headers = {
    "accept": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.post(url, headers=headers)

print(response.text)
// POST https://gate.whapi.cloud/newsletters/{NewsletterID}/subscription
// Subscribes your connected WhatsApp session to a specific target channel
const autoSubscribeSession = async (newsletterId) => {
  // if you pass a malformed newsletterId (e.g. missing '@newsletter'), the API will fail to match the channel
  const response = await fetch(`https://gate.whapi.cloud/newsletters/${newsletterId}/subscription`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
      'Content-Type': 'application/json'
    }
  });

  if (!response.ok) {
    throw new Error(`Subscription Failed: ${response.status}`);
  }

  console.log(`Successfully subscribed connection to channel: ${newsletterId}`);
};
OkHttpClient client = new OkHttpClient();

RequestBody body = RequestBody.create(null, new byte[0]);
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/subscription")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/subscription");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

Como recuperar e analisar mensagens de canais do WhatsApp

Si você está criando um analisador automático ou agregador de conteúdo, precisa extrair e analisar postagens de canais seguidos. O endpoint GET /newsletters/{NewsletterID}/messages permite que seu sistema consulte transmissões históricas e extraia textos, links ou mídias de forma programática.
Recomendamos fortemente o uso de parâmetros de paginação como count, before ou after para sincronizar o conteúdo de forma incremental. Isso permite que você execute tarefas cron de scraping em segundo plano (por exemplo, por hora ou por dia) para analisar e salvar atualizações de canais diretamente em seu CRM, CMS ou banco de dados (como PostgreSQL ou MongoDB) sem gerar carga desnecessária na API.
curl --request GET \
     --url 'https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/messages?count=50' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN'
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/messages?count=50', [
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
  ],
]);

echo $response->getBody();
import requests

url = "https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/messages"
params = {"count": "50"}
headers = {
    "accept": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, params=params, headers=headers)

print(response.text)
// GET https://gate.whapi.cloud/newsletters/{NewsletterID}/messages
// Pulls channel historical feed data with pagination
const syncChannelHistory = async (newsletterId, limitCount = 50) => {
  const url = `https://gate.whapi.cloud/newsletters/${newsletterId}/messages?count=${limitCount}`;
  
  const response = await fetch(url, {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`
    }
  });

  if (!response.ok) {
    throw new Error(`Failed to fetch history: ${response.status}`);
  }

  const { messages } = await response.json();
  // We recommend enforcing database upserts using the message.id as unique constraint to avoid duplicates
  messages.forEach(msg => {
    console.log(`[${msg.timestamp}] Message ID: ${msg.id} - Content: ${msg.body || 'Media Post'}`);
  });
  return messages;
};
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/messages?count=50")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/messages?count=50");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

Como enviar cartões de convite de canais via API

Para distribuir cartões de adesão limpos e personalizados aos seus usuários (por exemplo, dentro de uma sequência de onboarding), o WhatsApp suporta links de convite de canal nativos. Antes de enviar um cartão de adesão estilizado, você precisa recuperar o código de convite exclusivo do seu canal.
Você pode encontrar esse código dentro do parâmetro invite_code ao chamar GET /newsletters ou GET /newsletters/{NewsletterID}. O código retornado é uma string alfanumérica (por exemplo, TESTCODE12345).
Uma vez que você tenha o código de convite, inicie uma solicitação POST para o endpoint POST /newsletters/link/{NewsletterInviteCode}. Este método permite enviar um cartão de convite personalizável para qualquer contato privado, com estilos de visualização de alta qualidade e texto CTA personalizado para maximizar a taxa de conversão.
curl --request POST \
     --url https://gate.whapi.cloud/newsletters/link/TESTCODE12345 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "4915155985667",
  "body": "Follow this link to join our automated developer newsletter on WhatsApp: %URL%",
  "title": "Join Developer Updates",
  "preview_type": "style2"
}
'
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/newsletters/link/TESTCODE12345', [
  'body' => '{"to":"4915155985667","body":"Follow this link to join our automated developer newsletter on WhatsApp: %URL%","title":"Join Developer Updates","preview_type":"style2"}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();
import requests

url = "https://gate.whapi.cloud/newsletters/link/TESTCODE12345"

payload = {
    "to": "4915155985667",
    "body": "Follow this link to join our automated developer newsletter on WhatsApp: %URL%",
    "title": "Join Developer Updates",
    "preview_type": "style2"
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
// POST https://gate.whapi.cloud/newsletters/link/{NewsletterInviteCode}
// Distribute a newsletter invite card programmatically with a customized visual preview
const distributeInviteCard = async (inviteCode, recipientPhone) => {
  const response = await fetch(`https://gate.whapi.cloud/newsletters/link/${inviteCode}`, {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: recipientPhone,
      body: "Follow this link to join our automated developer newsletter on WhatsApp: %URL%",
      title: "Join Developer Updates",
      preview_type: "style2" // Applies clean, flat infographic preview style to invitation card
    })
  });

  if (!response.ok) {
    throw new Error(`Failed to send invite card: ${response.status}`);
  }

  console.log(`Invite card successfully dispatched to ${recipientPhone}`);
};
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\":\"4915155985667\",\"body\":\"Follow this link to join our automated developer newsletter on WhatsApp: %URL%\",\"title\":\"Join Developer Updates\",\"preview_type\":\"style2\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/newsletters/link/TESTCODE12345")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/newsletters/link/TESTCODE12345");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
request.AddJsonBody("{\"to\":\"4915155985667\",\"body\":\"Follow this link to join our automated developer newsletter on WhatsApp: %URL%\",\"title\":\"Join Developer Updates\",\"preview_type\":\"style2\"}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

Segurança e proteção: Designar programaticamente administradores secundários

Um risco importante ao executar newsletters de alto volume é perder o acesso devido a desconexões repentinas de telefone ou bloqueios padrão contra spam. Para proteger seu canal de transmissão, você deve automatizar imediatamente o processo de designação de administradores secundários ou de backup.
Se sua conta principal de bot for desconectada, um administrador secundário mantém o controle total sobre o canal, permitindo que você restaure as operações e vincule um novo número sem perder sua base de assinantes. Este processo de segurança é executado em duas etapas: primeiro, envie um convite de administrador; segundo, aceite e ative esses direitos administrativos no canal.
Você pode implementar isso programaticamente em seu backend Node.js ou servidor de baixo código como um padrão defensivo de resiliência.
curl --request POST \
     --url https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/invite/4915155985667 \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "message": "You are invited to become a channel administrator."
}
'
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/invite/4915155985667', [
  'body' => '{"message":"You are invited to become a channel administrator."}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();
import requests

url = "https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/invite/4915155985667"

payload = {
    "message": "You are invited to become a channel administrator."
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
// Node.js Implementation of the Dynamic Invitation Pipeline
const adminOnboardingPipeline = async (newsletterId, contactId) => {
  try {
    // Step 1: Send an administrator invitation to the contact
    // POST /newsletters/{NewsletterID}/invite/{ContactID}
    const inviteResponse = await fetch(`https://gate.whapi.cloud/newsletters/${newsletterId}/invite/${contactId}`, {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({
        message: "You have been invited to manage our automated broadcast feed. Click accept."
      })
    });

    if (!inviteResponse.ok) {
      throw new Error(`Admin Invitation Failed: ${inviteResponse.status}`);
    }

    console.log(`Step 1 Complete: Admin invite dispatched to ${contactId}`);

    // Step 2: Auto-confirm and accept the admin request
    // PUT /newsletters/{NewsletterID}/admins/{ContactID}
    // Note: In real production systems, you should trigger this second call in your webhook handler
    // once you receive the user's acceptance notification from WhatsApp.
    const acceptResponse = await fetch(`https://gate.whapi.cloud/newsletters/${newsletterId}/admins/${contactId}`, {
      method: 'PUT',
      headers: {
        'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
        'Content-Type': 'application/json'
      }
    });

    if (!acceptResponse.ok) {
      throw new Error(`Admin Activation Failed: ${acceptResponse.status}`);
    }

    console.log(`Step 2 Complete: Administrative access fully activated for ${contactId}`);
  } catch (error) {
    console.error(`Dynamic Invitation Pipeline broke: ${error.message}`);
  }
};
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"message\":\"You are invited to become a channel administrator.\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/invite/4915155985667")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/newsletters/120363171744447809@newsletter/invite/4915155985667");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
request.AddJsonBody("{\"message\":\"You are invited to become a channel administrator.\"}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);

Rotular automaticamente parcerias pagas para conformidade publicitária

Para conformidade com as regras de publicidade, os órgãos reguladores exigem etiquetas de patrocínio claras nos fluxos de mensagens. Você pode marcar programaticamente postagens patrocinadas com uma etiqueta de parceria paga.
Use o endpoint POST /newsletters/{NewsletterID}/messages/{MessageID}/paid_partnership. Isso força o WhatsApp a exibir um selo de divulgação em conformidade acima do corpo da postagem no feed do assinante.

Aumentar o engajamento com enquetes e testes nativos

Os canais do WhatsApp são tradicionalmente canais unidirecionais, mas a Whapi.Cloud permite um engajamento bidirecional ao oferecer suporte a enquetes interativas nativas em canais públicos.
Você pode enviar textos, imagens, vídeos e documentos, além de recursos interativos nativos como quizzes e cartões de perguntas e respostas usando os endpoints /messages/quiz e /messages/question.
Isso transforma um canal de transmissão passivo em uma experiência interativa envolvente para quizzes, pesquisas ou feedback do público.
curl --request POST \
     --url https://gate.whapi.cloud/messages/quiz \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "120363171744447809@newsletter",
  "title": "Does the official Meta WABA support WhatsApp Channels programmatically?",
  "options": ["Yes, fully supported", "Only via BSP partners", "No, it completely lacks support"],
  "correct_option_index": 2
}
'
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://gate.whapi.cloud/messages/quiz', [
  'body' => '{"to":"120363171744447809@newsletter","title":"Does the official Meta WABA support WhatsApp Channels programmatically?","options":["Yes, fully supported","Only via BSP partners","No, it completely lacks support"],"correct_option_index":2}',
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
    'content-type' => 'application/json',
  ],
]);

echo $response->getBody();
import requests

url = "https://gate.whapi.cloud/messages/quiz"

payload = {
    "to": "120363171744447809@newsletter",
    "title": "Does the official Meta WABA support WhatsApp Channels programmatically?",
    "options": ["Yes, fully supported", "Only via BSP partners", "No, it completely lacks support"],
    "correct_option_index": 2
}
headers = {
    "accept": "application/json",
    "content-type": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
// Node.js implementation for native interactive Channel Quizzes and Questions
const sendInteractivePolls = async (newsletterId) => {
  // 1. Send Question message to Channel
  // POST https://gate.whapi.cloud/messages/question
  const questionResponse = await fetch('https://gate.whapi.cloud/messages/question', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: newsletterId,
      body: "What is your primary bottleneck when integrating the official WhatsApp Business API?"
    })
  });

  if (questionResponse.ok) {
    console.log("Interactive Q&A card published to channel.");
  }

  // 2. Send Quiz message with a validated correct answer to Channel
  // POST https://gate.whapi.cloud/messages/quiz
  const quizResponse = await fetch('https://gate.whapi.cloud/messages/quiz', {
    method: 'POST',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`,
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({
      to: newsletterId,
      title: "Does the official Meta WABA support WhatsApp Channels programmatically?",
      options: ["Yes, fully supported", "Only via BSP partners", "No, it completely lacks support"],
      correct_option_index: 2 // Option 3 is marked correct
    })
  });

  if (quizResponse.ok) {
    console.log("Interactive trivia Quiz published to channel.");
  }
};
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\":\"120363171744447809@newsletter\",\"title\":\"Does the official Meta WABA support WhatsApp Channels programmatically?\",\"options\":[\"Yes, fully supported\",\"Only via BSP partners\",\"No, it completely lacks support\"],\"correct_option_index\":2}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/messages/quiz")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("content-type", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/messages/quiz");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
request.AddJsonBody("{\"to\":\"120363171744447809@newsletter\",\"title\":\"Does the official Meta WABA support WhatsApp Channels programmatically?\",\"options\":[\"Yes, fully supported\",\"Only via BSP partners\",\"No, it completely lacks support\"],\"correct_option_index\":2}", false);
var response = await client.PostAsync(request);

Console.WriteLine("{0}", response.Content);
Guia de Envio de Quizzes e Perguntas

O que significa @lid nos metadados de canais do WhatsApp?

Ao contrário dos grupos, os canais do WhatsApp são criados com privacidade estrita para os assinantes. Isso significa que os administradores não podem ver os números de telefone de seus assinantes. Em sua lista de metadatos ou ao gerenciar as atividades dos assinantes (como reações a postagens, votos em enquetes ou envios interativos personalizados), o WhatsApp oculta os números de telefone reais e retorna identificadores anônimos.
Esses identificadores mascarados seguem o formato 1524746986546@lid. Este é o formato JID nativo do WhatsApp para IDs de contatos mascarados. Para CRM e análise, você pode tentar resolver esses identificadores.
Usando o endpoint GET /contacts/ids/{ContactLID}, você pode consultar a Whapi.Cloud para resolver o LID anônimo em um número de telefone padrão, desde que sua conta vinculada tenha permissão ou histórico de interação anterior com esse destinatário.
curl --request GET \
     --url https://gate.whapi.cloud/contacts/ids/1524746986546@lid \
     --header 'accept: application/json' \
     --header 'authorization: Bearer YOUR_API_TOKEN'
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://gate.whapi.cloud/contacts/ids/1524746986546@lid', [
  'headers' => [
    'accept' => 'application/json',
    'authorization' => 'Bearer YOUR_API_TOKEN',
  ],
]);

echo $response->getBody();
import requests

url = "https://gate.whapi.cloud/contacts/ids/1524746986546@lid"

headers = {
    "accept": "application/json",
    "authorization": "Bearer YOUR_API_TOKEN"
}

response = requests.get(url, headers=headers)

print(response.text)
// GET https://gate.whapi.cloud/contacts/ids/{contactLid}
// Query standard phone numbers and identities using the anonymized JID lid
const resolveContactLid = async (contactLid) => {
  const response = await fetch(`https://gate.whapi.cloud/contacts/ids/${contactLid}`, {
    method: 'GET',
    headers: {
      'Authorization': `Bearer ${process.env.WHAPI_TOKEN}`
    }
  });

  if (!response.ok) {
    throw new Error(`Failed to resolve LID: ${response.status}`);
  }

  const { phone } = await response.json();
  console.log(`Successfully mapped LID ${contactLid} to Phone: ${phone}`);
  return phone; // Returns standard phone number without the '+' sign
};
OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/contacts/ids/1524746986546@lid")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer YOUR_API_TOKEN")
  .build();

Response response = client.newCall(request).execute();
using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/contacts/ids/1524746986546@lid");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer YOUR_API_TOKEN");
var response = await client.GetAsync(request);

Console.WriteLine("{0}", response.Content);

Implantação e infraestrutura para bots de canais do WhatsApp

Para executar canais de transmissão de grande volume e gerenciar eventos de webhooks em tempo real de maneira confiável, escolher o ambiente de implantação correto é crucial. Para cargas de trabalho pequenas ou de teste, as plataformas de baixo código como Make.com ou n8n cloud são excelentes escolhas que minimizam a sobrecarga do servidor.
No entanto, para produção, recomenda-se implantar um receptor de webhooks de backend dedicado em servidores (usando provedores de VPS como AWS, DigitalOcean ou Hetzner). Isso permite gerenciar transmissões de webhooks concorrentes, armazenar o histórico de payloads localmente e controlar limites de taxa diretamente.
Certifique-se de que seu servidor retorne um HTTP 200 OK imediato ao receber um payload de webhook. Tempos de processamento lentos podem causar gargalos nas solicitações, tentativas de reenvio e atrasos desnecessários. Execute tarefas pesadas (como gravações no banco de dados ou processamento de mídia) de forma assíncrona.

Integração de canais sem código: Make, n8n e Zapier

Você não precisa de um servidor personalizado para executar automações de canais. Integradores de negócios podem usar plataformas de baixo código como Make, n8n ou Zapier para criar fluxos de trabalho visuais.
Um caso de uso comum é postar de forma cruzada e automática qualquer atualização publicada em um canal do Telegram, feed RSS ou banco de dados diretamente em um canal do WhatsApp, economizando horas de esforço manual diário.
Você pode configurar estas integrações usando nós de cliente de solicitação HTTP padrão, que oferecem flexibilidade máxima e evitam interrupções na execução.
Essa configuração visual elimina o trabalho manual, reduzindo as tarefas administrativas e os atrasos de sincronização em até 90%.
  • Configuração do Make.com: Adicione um módulo "HTTP - Make a Request" como sua ação. Configure a URL para https://gate.whapi.cloud/messages/text. Selecione o método: POST. Nos Headers, adicione Authorization: Bearer YOUR_WHAPI_TOKEN. Defina o tipo de corpo como Raw, Content-Type como JSON (application/json). Sob Request Content, escreva: {"to": "1203632001928471@newsletter", "body": " - Read more: "}, mapeando variáveis dinâmicas.
  • Mapeamento de fluxo de trabalho do n8n: Se você estiver configurando uma integração do WhatsApp no n8n, crie um nó "HTTP Request". Configure la URL como https://gate.whapi.cloud/messages/text. Selecione o método: POST. Ative "Send Headers" e adicione Authorization com o valor Bearer YOUR_WHAPI_TOKEN. Defina o tipo de corpo do conteúdo como JSON. No editor de parâmetros JSON, mapee o corpo bruto como { "to": "1203632001928471@newsletter", "body": "=" }.
  • Disparadores de webhooks do Zapier: Crie um Zap com a ação "Webhooks by Zapier" -> "Custom Request". Defina o método como POST. Defina a URL como https://gate.whapi.cloud/messages/text. Em Data, forneça o payload JSON mapeando: {"to": "1203632001928471@newsletter", "body": "{telegram_message_text}"}. No painel Headers, defina Authorization como Bearer YOUR_WHAPI_TOKEN e Content-Type como application/json.

👉 Guia passo a passo sobre como usar a integração Whapi.Cloud com o Make.com

👉 Guia passo a passo sobre como integrar a Whapi.Cloud com o n8n

We won't cover setting up external UTM link shortening platforms or custom domain click-trackers here. These routing platforms belong to your distinct marketing analytics stack; our focus is purely on managing your channels and publishing structured posts programmatically via Whapi's core endpoints.

Escolhendo a melhor arquitetura para canais do WhatsApp automatizados

Escolher a arquitetura certa é crucial. Embora a API oficial da Meta careça totalmente de suporte para canais, a Whapi.Cloud fornece uma solução estável que não requer o gerenciamento de uma infraestrutura complexa.
Os desenvolvedores obtêm controle total sobre os fluxos de notícias do WhatsApp, as atribuições de administradores e as postagens interativas sem reiniciar contêineres, manter proxies ou se preocupar com a descontinuação da API.
Se precisar de ajuda ou tiver alguma dúvida sobre como otimizar seus fluxos de trabalho de transmissão, a equipe de suporte da Whapi.Cloud está sempre disponível via widget de chat em nosso site.
Começar grátis Ver preços
contents
FAQ sobre a API de canais do WhatsApp

Perguntas frequentes sobre automação de canais

Não. A API oficial do Meta WhatsApp Business carece totalmente de endpoints para criar, gerenciar, assinar ou enviar postagens para canais do WhatsApp (newsletters). Para automatizar os canais de transmissão, os desenvolvedores devem utilizar um provedor de gateway alternativo como a Whapi.Cloud.
Os grupos do WhatsApp são projetados para bate-papos em grupo multidirecionais (até 1024 membros), onde os participantes podem ver os números de telefone de outros membros. Os canais do WhatsApp são feeds de transmissão públicos de um para muitos com assinantes ilimitados, onde os dados do usuário (como os números de telefone) permanecem completamente ocultos, garantindo 100% de conformidade com a privacidade.
Não, ao usar a Whapi.Cloud, você não precisa de verificação de empresa da Meta ou aprovação de modelos de mensagem. Você conecta qualquer número de WhatsApp padrão instantaneamente escaneando um código QR e pode começar a enviar programaticamente qualquer conteúdo de transmissão de imediato.
Sim, a Whapi.Cloud suporta totalmente conteúdo interativo nos canais. Os desenvolvedores podem usar os endpoints POST /messages/quiz e POST /messages/question para enviar quizzes interativos com respostas corretas validadas ou cartões de perguntas e respostas diretamente para os assinantes de seu canal.
Para enviar uma mensagem para um canal do WhatsApp, use el endpoint POST /newsletters/{NewsletterID}/messages ou o método de envio padrão com o JID do canal (por exemplo, 1203632001928471@newsletter) como destinatário. Você pode enviar textos, imagens, vídeos, documentos ou elementos interativos.
Você pode recuperar postagens de canais enviando uma solicitação GET /newsletters/{NewsletterID}/messages, especificando os parâmetros de limite para paginar o histórico recente. Alternativamente, configure webhooks para receber atualizações em tempo real sempre que novas postagens forem publicadas nos canais que você segue.
line
Uso da API do WhatsApp
line

Veja o que nossos clientes construíram
com Whapi.Cloud

“Todas as manhãs a equipe de operações recebe os check-ins do dia do Guesty em uma única mensagem de WhatsApp: tags VIP, chegadas tardias e notas dos quartos. Ninguém precisa abrir o painel do PMS primeiro.”

Alertas de quartos do Guesty para o WhatsApp

Muhammad Hisham Akram
“Monitoramos feeds RSS, resumimos cada artigo, geramos uma imagem vertical e a publicamos no status do WhatsApp. As taxas de abertura superam o e-mail porque o status já está no aplicativo.”

Feed RSS para status diários do WhatsApp

Hamza Irshad
“Os pacientes agendam, consultam e remarcam consultas no WhatsApp 24 horas por dia, 7 dias por semana. Preços e perguntas delicadas nunca ficam com o bot — são transferidos para um atendente humano.”

Agendamentos de clínicas com transferência para humanos

Thelma Ekeli Ekomboni Ekema
“A equipe de campo registra as visitas em menos de um minuto. Duas vezes ao dia o grupo de WhatsApp mostra quem visitou, quem está ativo e quem não — os problemas surgem em horas, não no fim de semana.”

Resumos da equipe de campo duas vezes ao dia

Kenny Kwanto
“O bot responde mensagens rotineiras no WhatsApp, mas para no momento em que detecta uma intenção de emergência e direciona para um atendente. Ele não finge lidar com casos de risco de vida.”

Detecção de emergências e transferência para humanos

Akhil Devarapu
“Os lembretes de exames chegam a milhares de estudantes porque os envios são espaçados e o conteúdo varia. Um disparo em massa direto violaria os limites de spam do WhatsApp.”

Lembretes para estudantes com controle de limites

Gurkirat Singh
“As consultas do Gmail, WhatsApp e formulários web chegam a um único agente de CRM. A taxa de transferência fica abaixo de 25% e o custo do WhatsApp permanece uma taxa fixa por número.”

Agente de sucesso do cliente com IA multicanal

Ahsen Adil
“Gerenciar vários grupos do WhatsApp é simples com o Whapi.Cloud. Posso supervisionar a atividade do grupo, gerenciar administradores e postar atualizações sem esforço. É uma maneira perfeita de gerar leads diretamente dos grupos do WhatsApp.”

Gestão de Grupos e Geração de Leads a partir de Grupos do WhatsApp

Carlos da Silva
“Nosso hotel usa o WhatsApp para enviar aos hóspedes informações essenciais de check-in, como os códigos de acesso. Isso garante que eles sempre tenham as informações de que precisam. Podemos até processar fotos que os hóspedes enviam, como prova de checkout.”

Comunicação Inteligente para Check-In e Suporte ao Hóspede

Ana-Maria Ionescu
“Gerenciamos um Canal do WhatsApp e usamos o Whapi.Cloud para monitorar canais semelhantes e concorrentes, coletando as melhores ofertas e postando-as para nossa audiência.”

Gestão Automatizada de Canais de Desconto

Katrin Schneider
“Usamos o Whapi.Cloud para verificar quais números em nosso banco de dados estão no WhatsApp, enviando transmissões em cascata. Dessa forma, filtramos nossos contatos, reduzimos os custos de marketing e sabemos que nossas mensagens chegam a usuários ativos, maximizando a eficiência da campanha.”

Verificação de Números do WhatsApp e Filtragem de Público

Sergio Navarro
“O bot do nosso hospital, alimentado pelo Whapi.Cloud, permite que os pacientes vejam horários disponíveis para consultas com médicos específicos e os notifica quando os resultados dos exames estão prontos. Mantém todos informados e reduz o tempo que nossa equipe gasta com atualizações manuais.”

Bot para Agendamento de Consultas e Notificações em Hospitais

Fernanda Oliveira
“Usamos ofertas promocionais personalizadas para envolver os clientes semanas após a compra, enviando cupons de desconto exclusivos pelo WhatsApp. Também enviamos uma oferta especial no aniversário de cada cliente, o que aumenta a lealdade e os mantém voltando.”

Fidelização e Retenção de Clientes

Lukas Wagner
“Assim que um pedido é enviado, nossos clientes recebem detalhes de rastreamento e atualizações de entrega diretamente no WhatsApp. Esta comunicação em tempo real gera confiança e reduz o número de consultas que recebemos após a compra.”

Rastreamento de Pedidos e Atualizações de Entrega

Matei Popescu
“Se um cliente deixa itens em seu carrinho em nosso site, o Bot do WhatsApp envia automaticamente um lembrete amigável. Esse pequeno empurrão aumentou significativamente nossa taxa de finalização de compras, ajudando-nos a converter mais vendas.”

Lembretes de Carrinho Abandonado

Hans Müller
Ver depoimentos reais verificados
Desenvolvido e Gerenciado Internamente

O que é Whapi.Cloud?

Simples e poderoso! Whapi.Cloud é uma API intuitiva que permite conectar seu negócio ao WhatsApp de forma integrada.
Com Whapi.Cloud, você pode focar no que realmente importa – fazer seu negócio crescer.
Desfrute de infinitas possibilidades de integração, como criar bots de suporte, agendar compromissos, enviar notificações do WhatsApp e muito mais.
Além disso, monitore tudo sem esforço com webhooks. Começar nunca foi tão fácil!

Nosso serviço oferece controle total e gerenciamento de grupos, comunidades e canais do WhatsApp.

Adicione dinamismo e novos recursos: mídia, botões, reações, histórias, pedidos e produtos. Todos esses recursos estão disponíveis para a interação com o cliente.

Nossa equipe de atendimento responderá rapidamente e ajudará você com qualquer dúvida que possa ter!
Explorar automação do WhatsApp Ver
demonstração
Captura de tela da conta
Captura de tela da conta
Balão decorativo