Ofertas de afiliados en marketplaces por WhatsApp con la WhatsApp API

Caso de uso

Cuándo usar este flujo

Tu backend ya ingiere señales de ofertas de marketplace

Elige este flujo cuando tu propio backend detecta o ingiere señales de gangas y descuentos de Amazon, AliExpress o fuentes similares y aplica reglas de precio, descuento y deduplicación antes de que algo llegue a WhatsApp.

Monetizas con enlaces de afiliado y dominios cortos opcionales

Elige este flujo cuando cada URL de producto debe pasar por tu etiqueta de afiliado y un acortador opcional en tu backend antes de que los suscriptores la vean en WhatsApp.

El destino es un canal de WhatsApp, un grupo de ofertas o ambos

Elige este flujo cuando quienes te siguen deben ver la oferta en un canal de WhatsApp y/o un grupo de ofertas como post con vista previa de enlace, no como un envío masivo frío a números individuales.

Canal o chat de grupo de WhatsApp en un teléfono mostrando un post de oferta con vista previa de enlace, título, precio y enlace de producto de afiliado.

Experiencia del cliente

Quienes siguen ven la vista previa de la oferta en el chat

Sin automatización, un precio caliente del marketplace aparece en tu pipeline de ingestión mientras los suscriptores esperan a que alguien reescriba el enlace de afiliado y pegue un post formateado a mano.

Cuando el flujo termina, suscriptores del canal y miembros del grupo ven un post con vista previa de enlace con título del producto, precio y tu URL de seguimiento para comprar. Los integradores construyen este resultado con la WhatsApp API.

Flujo de trabajo

De una oferta de marketplace a una vista previa de enlace

Oferta de marketplace calificada

Tu backend ingiere o detecta una oferta de Amazon, AliExpress o fuente similar, inyecta tu etiqueta de afiliado y enlace corto opcional, y prepara título, precio y media de vista previa. Whapi.Cloud no rastrea marketplaces ni reescribe ids de afiliado.

Resuelve el id del canal una vez

GET /newsletters

getNewsletters lista tus canales para que elijas el JID del canal de ofertas, lo guardes en tu backend y omitas esta llamada en cada oferta posterior salvo que cambie el canal.

Resuelve el id del grupo de ofertas cuando haga falta

GET /groups

getGroups lista tus grupos para guardar el JID del grupo de ofertas cuando el fan-out a grupo está activo: llama una vez o cuando cambie el grupo objetivo, no en cada SKU.

Publica la vista previa de enlace de la oferta

POST /messages/link_preview

sendMessageLinkPreview envía la URL reescrita del producto en el cuerpo con título y media opcional a cada JID de destino configurado; repite la llamada cuando canal y grupo deban recibir la misma oferta.

Ver ejemplos de código

¿Necesitas seguir la entrega? Una respuesta de envío correcta no prueba que quienes te siguen ya vean el post de la oferta. Sigue los acks posteriores en webhooks de entrega. Aprende sobre el estado de entrega →

Requisitos previos

Antes de ejecutar el flujo

Conecta el número de WhatsApp que administra tu canal o grupo de ofertas y autentica cada solicitud con el token de API de ese número. La ingestión de marketplace, la reescritura de afiliados y la lógica de enlaces cortos se quedan en tu backend.

1. Crea una cuenta de Whapi.Cloud: Regístrate
2. Conecta tu cuenta de WhatsApp: Abrir la guía
3. Encuentra tu token de API: Abrir la sección

Opcional — profundiza en este flujo

Visión general de la API de canales de WhatsApp: Ver la visión general
Automatiza grupos de WhatsApp con la API: Abrir la guía
Visión general de la API de grupos de WhatsApp: Ver la visión general

Implementación de API

Las llamadas que publican la oferta

Tu backend ya calificó la oferta y tiene la URL de afiliado reescrita. Estas llamadas resuelven JIDs de destino cuando los necesitas y entregan el SKU como post con vista previa de enlace a tu canal y/o grupo de ofertas.

Obtén tu token de API gratis después de registrarte en whapi.cloud y usa ese token en el código en lugar de Your_Token de los ejemplos.

Resuelve el id del canal una vez

Lista tus canales para guardar el JID del canal de ofertas una vez antes de que empiecen los posts.

curl --request GET \
     --url https://gate.whapi.cloud/newsletters \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/newsletters",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

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

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

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

print(response.text)

const url = 'https://gate.whapi.cloud/newsletters';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
  },
});

console.log(await response.text());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/newsletters")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .build();

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

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_Token");
var response = await client.GetAsync(request);

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

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://gate.whapi.cloud/newsletters", nil)
	req.Header.Set("accept", "application/json")
	req.Header.Set("authorization", "Bearer Your_Token")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

Resuelve el id del grupo de ofertas cuando haga falta

Lista tus grupos para guardar el JID del grupo de ofertas cuando el fan-out a grupo forma parte de tu configuración.

curl --request GET \
     --url https://gate.whapi.cloud/groups \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/groups",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

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

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

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

print(response.text)

const url = 'https://gate.whapi.cloud/groups';

const response = await fetch(url, {
  method: 'GET',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
  },
});

console.log(await response.text());

OkHttpClient client = new OkHttpClient();

Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/groups")
  .get()
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .build();

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

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/groups");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
var response = await client.GetAsync(request);

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

package main

import (
	"fmt"
	"io"
	"net/http"
)

func main() {
	req, _ := http.NewRequest("GET", "https://gate.whapi.cloud/groups", nil)
	req.Header.Set("accept", "application/json")
	req.Header.Set("authorization", "Bearer Your_Token")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)
	fmt.Println(string(body))
}

Publica la vista previa de enlace de la oferta

Envía título, precio y URL reescrita a cada JID de destino guardado como anuncio con vista previa de enlace por cada oferta calificada.

curl --request POST \
     --url https://gate.whapi.cloud/messages/link_preview \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "1203632001928471@newsletter",
  "title": "Deal: wireless earbuds",
  "body": "Wireless earbuds now $29.99 \u2014 tap to buy: https://deals.example/a/xyz123",
  "media": "https://deals.example/a/xyz123/image.jpg"
}
'

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/messages/link_preview",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    "to" => "1203632001928471@newsletter",
    "title" => "Deal: wireless earbuds",
    "body" => "Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123",
    "media" => "https://deals.example/a/xyz123/image.jpg",
  ]),
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token",
    "content-type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

import requests

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

payload = {
  "to": "1203632001928471@newsletter",
  "title": "Deal: wireless earbuds",
  "body": "Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123",
  "media": "https://deals.example/a/xyz123/image.jpg",
}
headers = {
    "accept": "application/json",
    "authorization": "Bearer Your_Token",
    "content-type": "application/json"
}

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

print(response.text)

const url = 'https://gate.whapi.cloud/messages/link_preview';

const response = await fetch(url, {
  method: 'POST',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    to: '1203632001928471@newsletter',
    title: 'Deal: wireless earbuds',
    body: 'Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123',
    media: 'https://deals.example/a/xyz123/image.jpg',
  }),
});

console.log(await response.text());

OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\": \"1203632001928471@newsletter\", \"title\": \"Deal: wireless earbuds\", \"body\": \"Wireless earbuds now $29.99 \u2014 tap to buy: https://deals.example/a/xyz123\", \"media\": \"https://deals.example/a/xyz123/image.jpg\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/messages/link_preview")
  .post(body)
  .addHeader("accept", "application/json")
  .addHeader("authorization", "Bearer Your_Token")
  .addHeader("content-type", "application/json")
  .build();

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

using RestSharp;

var options = new RestClientOptions("https://gate.whapi.cloud/messages/link_preview");
var client = new RestClient(options);
var request = new RestRequest("");
request.AddHeader("accept", "application/json");
request.AddHeader("authorization", "Bearer Your_Token");
request.AddHeader("content-type", "application/json");
request.AddJsonBody(new {
  to = "1203632001928471@newsletter",
  title = "Deal: wireless earbuds",
  body = "Wireless earbuds now $29.99 — tap to buy: https://deals.example/a/xyz123",
  media = "https://deals.example/a/xyz123/image.jpg",
});
var response = await client.PostAsync(request);

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

package main

import (
	"bytes"
	"fmt"
	"io"
	"net/http"
)

func main() {
	body := []byte(`{"to": "1203632001928471@newsletter", "title": "Deal: wireless earbuds", "body": "Wireless earbuds now $29.99 \u2014 tap to buy: https://deals.example/a/xyz123", "media": "https://deals.example/a/xyz123/image.jpg"}`)
	req, _ := http.NewRequest("POST", "https://gate.whapi.cloud/messages/link_preview", bytes.NewReader(body))
	req.Header.Set("accept", "application/json")
	req.Header.Set("authorization", "Bearer Your_Token")
	req.Header.Set("content-type", "application/json")

	res, _ := http.DefaultClient.Do(req)
	defer res.Body.Close()
	out, _ := io.ReadAll(res.Body)
	fmt.Println(string(out))
}

Obtén la clave API gratis

Estado de entrega

Cuándo el post de la oferta sale de pending

Una respuesta de envío correcta no significa que quienes te siguen ya tengan el post de la oferta. El primer estado visible antes de un webhook es pending. Los cambios posteriores llegan solo en statuses.post y statuses.put. Si el estado se queda en pending y no pasa a sent, delivered o un ack posterior, el mensaje no se entregó: revisa la carga y el permiso de la cuenta para enviar ese tipo.

Trata un pending atascado como no entregado, no como un reloj o cola esperando un webhook.
Suscríbete a statuses.post y statuses.put cuando necesites confirmación de envío o entrega para posts en canal o grupo.
No marques la oferta de marketplace como totalmente publicada mientras el estado de WhatsApp siga en pending.

Qué leer sobre entrega y webhooks

Cómo se ve un webhook de entrega: Ver el callback
Qué eventos enviamos a un webhook: Ver eventos rastreados
Cómo poner un webhook en un canal: Abrir la guía
Dónde obtener la URL del webhook: Abrir la guía
Ejemplos de carga de webhook: Ver los formatos

Contacta a soporte si algo salió mal

Cuando algo falla

Trata los fallos en cada paso

Si la oferta pasó la ingestión pero falló la reescritura de afiliado, getNewsletters o getGroups no encuentran destino, el JID guardado es incorrecto, sendMessageLinkPreview se rechaza en una superficie mientras otra tuvo éxito, o el post nunca sale de pending, reintenta o avisa y no marques la oferta como totalmente publicada.

¿La oferta estaba lista, pero WhatsApp no publicó nada?

Mantén separado el estado de la oferta del marketplace de la entrega en WhatsApp. Confirma la salida de afiliado y enlace corto en tu backend, verifica JIDs de canal y grupo guardados, reintenta sendMessageLinkPreview para el destino fallido o avisa a operaciones: no marques el SKU publicado mientras quienes te siguen no tengan post. Si el post sigue fallando tras un reintento, contacta al soporte de Whapi con el id de destino y el id de la solicitud fallida.

Contacta a soporte si algo salió mal

Diagnostica por paso de API

Estado	Qué significa	Qué hacer
`400`	Wrong request parameters	Corrige parámetros incorrectos en la llamada de listado de newsletters antes de reintentar.
`500`	Internal Error

Estado	Qué significa	Qué hacer
`400`	Wrong request parameters	Corrige parámetros incorrectos en el cuerpo de vista previa de enlace antes de reintentar.
`401`	Need channel authorization for send message	Autoriza el canal para enviar mensajes y reintenta con un token válido.
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Confirma que está permitido enviar a este destinatario de canal o grupo y reintenta con un valor `to` corregido.
`404`	Media with specified id not found
`413`	Request media too large
`415`	Unsupported media type
`429`	Too many requests	Reduce la velocidad y reintenta más tarde tras demasiadas solicitudes.
`500`	Internal Error

Estado	Qué significa	Qué hacer
`400`	Wrong request parameters	Corrige parámetros incorrectos en la llamada de listado de grupos antes de reintentar.
`500`	Internal Error

Preguntas frecuentes

Ofertas de marketplace y publicación en WhatsApp

No. Tu backend ingiere señales de ofertas, aplica reglas de afiliado y enlace corto y decide cuándo un SKU está listo para publicar. Whapi.Cloud recibe el envío de WhatsApp después de que llamas sendMessageLinkPreview con la URL reescrita en el cuerpo.

No. Resuelve y guarda JIDs de destino una vez (o cuando cambie el canal o grupo) y reutiliza esos ids en posts posteriores con vista previa de enlace. Listar en cada tick de oferta añade latencia sin cambiar el escenario.

Sigue el failure_mode del catálogo: no marques la oferta como totalmente publicada, reintenta o avisa, y revisa la salida de reescritura de afiliado, JIDs guardados, envíos rechazados o un estado que siga en pending.

Los flujos RSS a canal se disparan por ítems de feed y referencian URLs de artículos del CMS. Este flujo se dispara por señales de ofertas de marketplace con URLs de afiliado y puede hacer fan-out a un grupo de ofertas además del canal.

Duplicar en Telegram u otros mensajeros queda en tu backend. Este trabajo cubre solo posts con vista previa de enlace en canal y/o grupo de WhatsApp.

Empieza con la API

Funciones compatibles de WhatsApp

Todo lo que necesitas para crear automatizaciones en WhatsApp

Whapi.Cloud te da acceso a un conjunto completo de funciones de WhatsApp — mensajería, multimedia, grupos, canales, webhooks y más. Crea bots, automatizaciones e integraciones sin limitaciones de funciones.

Elegido por desarrolladores

Confiado por más de 3.300 desarrolladores y equipos SaaS

Desarrolladores de todo el mundo confían en Whapi.Cloud para crear automatizaciones, bots, integraciones con CRM, herramientas de mensajería masiva y flujos avanzados de WhatsApp. Nuestra infraestructura procesa millones de solicitudes API con alta estabilidad, y este número crece cada mes.

5,5K+

canales API activos

21M+

solicitudes API al mes

Comenzar prueba gratuita Ver todas las reseñas

“Todo es simple, intuitivo y fácil de usar. La documentación es clara y toda la información está justo donde la necesito. Excelente trabajo.”

Roberto K. / Desarrollador Web

“Conectamos WhatsApp a nuestros flujos en n8n en solo unos minutos. Sin código, sin complicaciones — todo funcionó a la primera.”

Martin P. / Desarrollador

“Whapi.Cloud se convirtió en una parte clave de nuestra comunicación con clientes. Automatizamos actualizaciones de productos, notificaciones de pedidos y mensajes de soporte — sin plantillas ni aprobaciones de Meta.”

Oscar T. / CTO

Relacionado

Más flujos de ofertas y publicación

RSS de WordPress a canal de WhatsApp con vista previa de enlace (hermano, no ofertas de marketplace)

Publicar texto plano en un canal cuando el CMS publica contenido (hermano, no ofertas con vista previa)

API de canales de WhatsApp — publicar actualizaciones y gestionar canales

Automatizar grupos de WhatsApp — fan-out a grupo de ofertas y JIDs de grupo guardados

Visión general de la API de grupos de WhatsApp — listar grupos antes de publicar ofertas

Casos de estudio de automatización WhatsApp para marketplaces y comercio electrónico

Cuándo usar este flujo

Quienes siguen ven la vista previa de la oferta en el chat

De una oferta de marketplace a una vista previa de enlace

Antes de ejecutar el flujo

Las llamadas que publican la oferta

Resuelve el id del canal una vez

Resuelve el id del grupo de ofertas cuando haga falta

Publica la vista previa de enlace de la oferta

Cuándo el post de la oferta sale de pending

Qué leer sobre entrega y webhooks

Trata los fallos en cada paso

Diagnostica por paso de API

Lista canales y elige el JID a guardar para posts de ofertas. getNewsletters · GET /newsletters

Publica la vista previa de enlace de la oferta en cada JID de destino guardado. sendMessageLinkPreview · POST /messages/link_preview

Lista grupos y elige el JID del grupo de ofertas a guardar cuando el fan-out a grupo está activo. getGroups · GET /groups

Ofertas de marketplace y publicación en WhatsApp

¿Whapi.Cloud encuentra ofertas de Amazon o AliExpress por mí?

¿Debo llamar getNewsletters y getGroups en cada oferta?

¿Qué pasa si la ingestión tuvo éxito pero nadie vio la oferta?

¿En qué se diferencia de publicar ítems RSS en un canal?

¿Puedo duplicar la misma oferta en Telegram desde Whapi?

Todo lo que necesitas para crear automatizaciones en WhatsApp

API de Canales de WhatsApp

Grupos y Comunidades de WhatsApp

Sin plantillas ni aprobaciones

Webhooks en tiempo real

Todos los tipos de medios y mensajes

Automatización de pedidos y productos

Validación de números de WhatsApp

Compatible con low-code y no-code

API de Estados de WhatsApp

Estado de entrega y lectura

Conexión multidispositivo

Mensajes interactivos y botones

Confiado por más de 3.300 desarrolladores y equipos SaaS

5,5K+

21M+

“Todo es simple, intuitivo y fácil de usar. La documentación es clara y toda la información está justo donde la necesito. Excelente trabajo.”

“Conectamos WhatsApp a nuestros flujos en n8n en solo unos minutos. Sin código, sin complicaciones — todo funcionó a la primera.”

“Whapi.Cloud se convirtió en una parte clave de nuestra comunicación con clientes. Automatizamos actualizaciones de productos, notificaciones de pedidos y mensajes de soporte — sin plantillas ni aprobaciones de Meta.”

Más flujos de ofertas y publicación