¡Guau! Emoji de hombre feliz Sandbox completo con todas las funciones para desarrolladores — gratis para siempre! Regístrate ahora
Guía de la API de canales de WhatsApp

Cómo administrar y automatizar canales de WhatsApp a través de la API

Actualizado el 5 de agosto de 2026

Esta guía técnica de Whapi.Cloud explica cómo administrar y automatizar de manera programática los canales de WhatsApp (boletines) a través de la API REST. Mientras que la API oficial de Meta (WABA) carece por completo de endpoints de canales de difusión, la puerta de enlace de sockets de sesión web de Whapi.Cloud proporciona las herramientas de desarrollo y los flujos de trabajo sin código (Make, n8n, Zapier) necesarios para automatizar la creación de canales, el onboarding de suscriptores y las publicaciones interactivas sin retrasos de infraestructura.

Manage WhatsApp channels easily via API
TL;DR: La API oficial de Meta WABA carece de funciones de canales de difusión. Para la difusión automatizada, conecte su número a través de la puerta de enlace de sockets de sesión web de Whapi.Cloud en menos de 2 minutos. Use el endpoint POST /newsletters para crear canales de forma programática y asocie cargas útiles JSON dinámicas en n8n o Make para automatizar la publicación cruzada sin tarifas por mensaje.

Por qué falla la API oficial de Meta (WABA) para los canales de WhatsApp

La API oficial de WhatsApp Business de Meta ofrece cero funciones de canales de difusión. No existen endpoints para crear canales, publicar actualizaciones o administrar suscriptores en el entorno de la API oficial de Meta.
Si desea automatizar boletines informativos, enviar difusiones de noticias o crear fuentes de canales programáticas, las credenciales oficiales no funcionarán. Whapi.Cloud proporciona acceso directo y completo a la API REST de canales de WhatsApp al vincular cualquier número de teléfono estándar a través de un protocolo de sesión web de forma estable.
Característica / Capacidad Meta WABA Oficial (API de la nube) Puerta de enlace de API de canales Whapi.Cloud
Canales de WhatsApp (Boletines) No compatible (0% de funcionalidad) Acceso completo a la API REST
Modelo de precios de mensajes Tarifas variables de Meta por mensaje + recargos del BSP Suscripción mensual fija (mensajes ilimitados)
Onboarding y verificación Verificación compleja de Facebook Business (días/semanas) Escaneo instantáneo de código QR (menos de 2 minutos)
Plantillas de mensajes y HSM Aprobación previa obligatoria para todas las difusiones No se requieren plantillas; envíe cualquier contenido libremente
Canales interactivos (Cuestionarios/Preguntas) No compatible Encuestas nativas, cuestionarios y tarjetas de preguntas y respuestas

Cómo vincular su WhatsApp y comenzar a usar la API

Antes de poder crear canales o enviar difusiones, debe conectar su número de WhatsApp a Whapi.Cloud para obtener un token de API.
Cree una cuenta gratuita en el panel de control de Whapi.Cloud. No necesita una tarjeta de crédito para comenzar, y un canal de prueba gratuito estará listo para usted de inmediato.
Escanee el código QR con su teléfono. Esto conecta su número de WhatsApp a través de sockets estables de sesión web, similar a vincular WhatsApp Web, pero ejecutándose de forma segura en nuestros servidores.
Crear una cuenta
Cómo conectar su dispositivo:
  1. 1) Vaya a su panel de control de Whapi.Cloud y localice su canal predeterminado.
  2. 2) Abra WhatsApp en su dispositivo móvil.
  3. 3) Vaya a Configuración -> Dispositivos vinculados -> Vincular un dispositivo.
  4. 4) Escanee el código QR que se muestra en la pantalla.
Su token de API seguro único se mostrará en el centro de la página del canal conectado.
Este token es esencial para autenticar las solicitudes de API; debe incluirse en los encabezados de las solicitudes como un token Bearer o pasarse como un parámetro, según el método.
open WhatsApp on your mobile device, go to Settings -> Connected devices
Vaya a Dispositivos vinculados en la configuración de WhatsApp
Scan the QR code in your WhatsApp
Scan the QR code with your device
Whatsapp API start working
La conexión de WhatsApp se ha establecido con éxito
Get WhatsApp API Key
Copie su token de API seguro de Whapi.Cloud
Exploremos las solicitudes clave de la API para administrar canales de forma programática.
Soporte y Guía de inicio

Cómo automatizar canales de WhatsApp a través de la API REST

Para crear un canal de WhatsApp completamente nuevo de manera programática, envíe una solicitud POST al endpoint /newsletters. Esto es ideal para plataformas, SaaS o redes multicanal que necesitan aprovisionar entornos de difusión separados para diferentes creadores o sucursales de forma automática.
En la carga útil de su solicitud, proporcione el name (nombre) del canal y una descripción opcional description. También puede cargar una imagen de perfil en el parámetro newsletter_pic. La API devuelve un newsletter_id único en el formato 120363..._example@newsletter, que utilizará para dirigir todas las difusiones 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);

Cómo enviar publicaciones a canales de WhatsApp a través de la API

Para publicar mensajes o actualizaciones multimedia en un canal de WhatsApp, su sistema debe enviar solicitudes al JID del canal correspondiente. Si no conoce el ID de su canal (JID), use el endpoint GET /newsletters para recuperar una lista de todos los canales vinculados a su cuenta.
El ID del canal seguirá el formato estándar: 120363171744447809@newsletter. Una vez que tenga este identificador único, enviar un mensaje es tan simple como iniciar una solicitud POST.
Use el endpoint POST /messages/text, pasando el JID del canal en el parámetro to y el texto plano en el parámetro body. Esto le permite difundir anuncios, enlaces o alertas de forma programática a toda su base de suscriptores al instante.
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);
Soporte y Guía de inicio

Cómo suscribir su sesión o bot a un canal de WhatsApp

El endpoint POST /newsletters/{NewsletterID}/subscription está diseñado para suscribir su propio número de WhatsApp conectado a cualquier canal de destino. Esto es sumamente útil para crear scrapers, analizadores o rastreadores de contenido que necesitan seguir automáticamente canales de noticias, fuentes de competidores o hilos de anuncios.
Para la seguridad y validación de la API, asegúrese de pasar el newsletter_id completo (incluyendo el sufijo @newsletter) en la ruta de la URL. Una vez suscrita, su sesión de bot recibirá todos los mensajes y medios recién publicados en tiempo real a través de 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);

Cómo recuperar y analizar mensajes de canales de WhatsApp

Si está creando un analizador automático o un agregador de contenido, necesita extraer y analizar publicaciones de canales seguidos. El endpoint GET /newsletters/{NewsletterID}/messages permite a su sistema consultar difusiones históricas y extraer texto, enlaces o recursos multimedia de manera programática.
Recomendamos encarecidamente utilizar parámetros de paginación como count, before o after para sincronizar el contenido de forma incremental. Esto le permite ejecutar tareas cron de scraping en segundo plano (por ejemplo, por hora o por día) para analizar y guardar las actualizaciones de canales directamente en su CRM, CMS o base de datos (como PostgreSQL o MongoDB) sin generar una carga innecesaria en la 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);

Cómo enviar tarjetas de invitación a canales a través de la API

Para distribuir tarjetas de unión limpias y personalizadas a sus usuarios (por ejemplo, dentro de una secuencia de onboarding), WhatsApp admite enlaces de invitación de canal nativos. Antes de poder enviar una tarjeta de unión estilizada, debe recuperar el código de invitación único de su canal.
Puede encontrar este código dentro del parámetro invite_code al llamar a GET /newsletters o GET /newsletters/{NewsletterID}. El código devuelto es una cadena alfanumérica (por ejemplo, TESTCODE12345).
Una vez que tenga el código de invitación, inicie una solicitud POST al endpoint POST /newsletters/link/{NewsletterInviteCode}. Este método le permite enviar una tarjeta de invitación personalizable a cualquier contacto privado, con estilos de vista previa de alta calidad y texto CTA personalizado para maximizar la tasa de conversión.
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);

Seguridad y protección: Designar programáticamente administradores de respaldo

Un riesgo importante al ejecutar boletines de alto volumen es perder el acceso debido a desconexiones repentinas del teléfono o bloqueos estándar contra el spam. Para proteger su canal de difusión, debe automatizar de inmediato el proceso de designación de administradores secundarios o de respaldo.
Si su cuenta de bot principal se desconecta, un administrador secundario mantiene el control total sobre el canal, lo que le permite restaurar las operaciones y vincular un nuevo número sin perder su base de suscriptores. Este proceso de seguridad se ejecuta en dos pasos: primero, envíe una invitación de administrador; segundo, acepte y active esos derechos administrativos en el canal.
Puede implementar esto de manera programática dentro de su backend de Node.js o servidor de bajo código como un patrón de resiliencia defensivo.
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);

Etiquetar automáticamente asociaciones pagadas para el cumplimiento publicitario

Para el cumplimiento normativo de la publicidad, los marcos regulatorios requieren etiquetas de patrocinio claras en las fuentes de mensajes. Puede etiquetar de forma programática las publicaciones patrocinadas con una etiqueta de asociación pagada.
Use el endpoint POST /newsletters/{NewsletterID}/messages/{MessageID}/paid_partnership. Esto obliga a WhatsApp a mostrar una etiqueta de divulgación de cumplimiento sobre el cuerpo de la publicación en la fuente del suscriptor.

Aumentar la interacción con encuestas y cuestionarios nativos

Los canales de WhatsApp son tradicionalmente fuentes unidireccionales, pero Whapi.Cloud permite una interacción bidireccional al admitir encuestas y preguntas interactivas nativas dentro de canales públicos.
Puede enviar texto, imágenes, de vídeo y documentos, así como recursos interactivos nativos como cuestionarios y tarjetas de preguntas y respuestas utilizando los endpoints /messages/quiz y /messages/question.
Esto convierte una fuente de difusión pasiva en una experiencia interactiva atractiva para cuestionarios, encuestas o comentarios del 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);
Guía de envío de cuestionarios y preguntas

Qué significa @lid en los metadatos de canales de WhatsApp?

A diferencia de los grupos, los canales de WhatsApp están diseñados con una estricta privacidad para los suscriptores. Esto significa que los administradores no pueden ver los números de teléfono de sus suscriptores del canal. En su lista de metadatos o al manejar las actividades de los suscriptores (como reacciones a publicaciones, votos en encuestas o envíos interactivos personalizados), WhatsApp oculta los números de teléfono reales y devuelve identificadores anónimos en su lugar.
Estos identificadores enmascarados siguen el formato 1524746986546@lid. Este es el formato JID nativo de WhatsApp para ID de contactos enmascarados. Para el mapeo de CRM y análisis, puede intentar resolver estos identificadores.
Usando el endpoint GET /contacts/ids/{ContactLID}, puede consultar a Whapi.Cloud para resolver el LID anónimo en un número de teléfono estándar, siempre que su cuenta vinculada tenga permiso o historial de interacción previa con ese destinatario.
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);

Implementación e infraestructura para bots de canales de WhatsApp

Para ejecutar canales de difusión de gran volumen y manejar eventos de webhooks en tiempo real de manera confiable, elegir el entorno de implementación adecuado es fundamental. Para cargas de trabajo pequeñas o de prueba, las plataformas de bajo código como Make.com o n8n cloud son excelentes opciones que minimizan la sobrecarga del servidor.
Sin embargo, para un nivel de producción, se recomienda implementar un receptor de webhooks de backend dedicado en servidores (utilizando proveedores de VPS como AWS, DigitalOcean o Hetzner). Esto le permite manejar transmisiones de webhooks concurrentes, almacenar el historial de carga útil localmente y controlar los límites de velocidad directamente.
Asegúrese de que su servidor devuelva un HTTP 200 OK inmediato al recibir una carga útil de webhook. Los tiempos de procesamiento lentos pueden causar cuellos de botella en las solicitudes, reintentos y demoras innecesarias. Ejecute tareas pesadas (como escrituras de base de datos o procesamiento de medios) de forma asincrónica.

Integración de canales sin código: Make, n8n y Zapier

No necesita un servidor personalizado para ejecutar automatizaciones de canales. Los integradores comerciales pueden usar plataformas de bajo código como Make, n8n o Zapier para crear flujos de trabajo visuales.
Un caso de uso común es publicar de forma cruzada y automática cualquier actualización publicada en un canal de Telegram, canal RSS o base de datos directamente en un canal de WhatsApp, ahorrando horas de esfuerzo manual diario.
Puede configurar estas integraciones utilizando nodos de cliente de solicitud HTTP estándar, que ofrecen la máxima flexibilidad y evitan paradas en la ejecución.
Esta configuración visual elimina el trabajo manual, reduciendo las tareas administrativas y los retrasos de sincronización hasta en un 90%.
  • Configuración de Make.com: Agregue un módulo "HTTP - Make a Request" como su acción. Configure la URL en https://gate.whapi.cloud/messages/text. Seleccione el método: POST. En los Headers, agregue Authorization: Bearer YOUR_WHAPI_TOKEN. Establezca el tipo de cuerpo en Raw, el Content-Type en JSON (application/json). Bajo Request Content, escriba: {"to": "1203632001928471@newsletter", "body": " - Read more: "}, asignando variables dinámicas.
  • Mapeo de flujo de trabajo de n8n: Si está configurando una integración de WhatsApp en n8n, cree un nodo "HTTP Request". Configure la URL como https://gate.whapi.cloud/messages/text. Seleccione el método: POST. Active "Send Headers" y agregue Authorization con el valor Bearer YOUR_WHAPI_TOKEN. Establezca el tipo de cuerpo del contenido en JSON. En el editor de parámetros JSON, mapee el cuerpo como { "to": "1203632001928471@newsletter", "body": "=" }.
  • Activación de webhooks de Zapier: Cree un Zap con la acción "Webhooks by Zapier" -> "Custom Request". Configure el método en POST. Establezca la URL en https://gate.whapi.cloud/messages/text. Bajo Data, proporcione la carga útil JSON sin procesar mapeando: {"to": "1203632001928471@newsletter", "body": "{telegram_message_text}"}. En el panel Headers, defina Authorization como Bearer YOUR_WHAPI_TOKEN y Content-Type como application/json.

👉 Guía paso a paso sobre cómo usar la integración de Whapi.Cloud con Make.com

👉 Guía paso a paso sobre cómo integrar Whapi.Cloud con 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.

Elección de la mejor arquitectura para canales de WhatsApp automatizados

Elegir la arquitectura adecuada es fundamental. Mientras que la API oficial de Meta carece por completo de soporte para canales, Whapi.Cloud proporciona una solución estable que no requiere el mantenimiento de una infraestructura compleja.
Los desarrolladores obtienen un control total sobre las fuentes de noticias de WhatsApp, las asignaciones de administradores y las publicaciones interactivas sin reiniciar contenedores, mantener proxies o preocuparse por el desuso de la API.
Si necesita ayuda o tiene alguna pregunta sobre cómo optimizar sus flujos de trabajo de difusión, el equipo de soporte de Whapi.Cloud siempre está disponible a través del widget de chat en nuestro sitio web.
Comenzar gratis Ver precios
contents
Preguntas frecuentes sobre la API de canales de WhatsApp

Preguntas frecuentes sobre la automatización de canales

No. La API oficial de Meta WhatsApp Business carece por completo de endpoints para crear, administrar, suscribirse o enviar publicaciones a canales de WhatsApp (boletines). Para automatizar los canales de difusión, los desarrolladores deben utilizar un proveedor de puerta de enlace alternativo como Whapi.Cloud.
Los grupos de WhatsApp están diseñados para chats grupales multidireccionales (hasta 1024 miembros) donde los participantes pueden ver los números de teléfono de otros miembros. Los canales de WhatsApp son fuentes de difusión públicas de uno a muchos con suscriptores ilimitados donde los datos del usuario (como los números de teléfono) permanecen completamente ocultos, lo que garantiza el 100% de cumplimiento de la privacidad.
No, al usar Whapi.Cloud, no necesita la verificación comercial de Meta ni la aprobación de plantillas de mensajes. Conecta cualquier número de WhatsApp estándar instantáneamente escaneando un código QR y puede comenzar a enviar de forma programática cualquier contenido de difusión de inmediato.
Sí, Whapi.Cloud admite totalmente el contenido interactivo en los canales. Los desarrolladores pueden usar los endpoints POST /messages/quiz y POST /messages/question para enviar cuestionarios interactivos de preguntas con respuestas correctas validadas o tarjetas de preguntas y respuestas directamente a los suscriptores de su canal.
Para enviar un mensaje a un canal de WhatsApp, use el endpoint POST /newsletters/{NewsletterID}/messages o el endpoint de mensajería estándar con el JID del canal (por ejemplo, 1203632001928471@newsletter) como destinatario. Puede enviar texto, imágenes, videos, documentos o elementos interactivos.
Puede recuperar publicaciones de canales enviando una solicitud GET /newsletters/{NewsletterID}/messages, especificando parámetros de límite para paginar el historial reciente. Alternativamente, configure webhooks para recibir actualizaciones en tiempo real cada vez que se publique contenido nuevo en sus canales suscritos.
line
Uso de Bots de WhatsApp
line

Vea lo que nuestros clientes construyeron
con Whapi.Cloud

“Gestionar múltiples grupos de WhatsApp es sencillo con Whapi.Cloud. Puedo supervisar la actividad de los grupos, gestionar administradores y publicar actualizaciones sin esfuerzo. Es una forma perfecta de generar prospectos directamente desde los grupos de WhatsApp.”

Gestión de Grupos y Generación de Prospectos desde Grupos de WhatsApp

Carlos da Silva
“Nuestro hotel utiliza WhatsApp para enviar a los huéspedes detalles esenciales de check-in, como los códigos de acceso. Esto asegura que siempre tengan la información que necesitan. Incluso podemos procesar fotos que envían los huéspedes, como prueba de salida.”

Comunicación Inteligente en Hoteles para Check-In y Soporte al Huésped

Ana-Maria Ionescu
“Gestionamos un Canal de WhatsApp y utilizamos Whapi.Cloud para monitorear canales similares y competidores, recopilando las mejores ofertas y publicándolas para nuestra audiencia.”

Gestión Automatizada de Canales de Descuento

Katrin Schneider
“Usamos Whapi.Cloud para verificar qué números en nuestra base de datos están en WhatsApp enviando transmisiones en cascada. De esta manera, filtramos nuestros contactos, reducimos costos de marketing y sabemos que nuestros mensajes llegan a usuarios activos, maximizando la eficiencia de la campaña.”

Verificación de Números de WhatsApp y Filtrado de Audiencia

Sergio Navarro
“El bot de nuestro hospital, impulsado por Whapi.Cloud, permite a los pacientes ver los horarios disponibles para citas con médicos específicos y les notifica cuando los resultados de sus exámenes están listos. Mantiene a todos informados y reduce el tiempo que nuestro equipo dedica a actualizaciones manuales.”

Bot Hospitalario para Programación de Citas y Notificaciones

Fernanda Oliveira
“Usamos ofertas promocionales personalizadas para atraer a los clientes semanas después de su compra, enviándoles cupones de descuento exclusivos a través de WhatsApp. También enviamos una oferta especial por el cumpleaños de cada cliente, lo que aumenta la lealtad y hace que vuelvan.”

Fidelización y Retención de Clientes

Lukas Wagner
“Tan pronto como un pedido se envía, nuestros clientes reciben detalles de seguimiento y actualizaciones de entrega directamente en WhatsApp. Esta comunicación en tiempo real genera confianza y reduce el número de consultas que recibimos después de la compra.”

Seguimiento de Pedidos y Actualizaciones de Entrega

Matei Popescu
“Si un cliente deja artículos en su carrito en nuestro sitio, el Bot de WhatsApp envía automáticamente un recordatorio amistoso. Este suave empujón ha incrementado significativamente nuestra tasa de finalización de compra, ayudándonos a convertir más ventas.”

Recordatorios de Carrito Abandonado

Hans Müller
Desarrollado y Gestionado Internamente

¿Qué es Whapi.Cloud?

¡Sencillo y potente! Whapi.Cloud es una API intuitiva que te permite conectar tu negocio con WhatsApp de manera fluida.
Con Whapi.Cloud, puedes centrarte en lo que realmente importa: hacer crecer tu negocio.
Disfruta de infinitas posibilidades de integración, como construir bots de soporte, programar citas, enviar notificaciones de WhatsApp y mucho más.
Además, monitorea todo sin esfuerzo con webhooks. ¡Nunca ha sido tan fácil empezar!

Nuestro servicio proporciona control total y gestión de grupos, comunidades y canales de WhatsApp.

Agrega dinamismo y nuevas funciones: medios, botones, reacciones, historias, pedidos y productos. Todo esto está disponible para la interacción con el cliente.

¡Nuestro equipo de atención responderá rápidamente y te ayudará con cualquier pregunta que tengas!
Explorar la automatización de WhatsApp Ver
demo
Captura de pantalla de la cuenta
Captura de pantalla de la cuenta
Burbuja decorativa