Ofertas de afiliados em marketplaces no WhatsApp com a WhatsApp API

Caso de uso · API

Quando usar este fluxo

O seu backend já ingere sinais de ofertas de marketplace

Escolha este fluxo quando o seu backend detecta ou ingere sinais de promoções e descontos da Amazon, AliExpress ou fontes similares e aplica regras de preço, desconto e deduplicação antes de qualquer coisa chegar ao WhatsApp.

Monetiza com links de afiliado e domínios curtos opcionais

Escolha este fluxo quando cada URL de produto tem de passar pela sua tag de afiliado e encurtador opcional no backend antes dos subscritores a verem no WhatsApp.

O destino é um canal WhatsApp, um grupo de ofertas ou ambos

Escolha este fluxo quando seguidores devem ver a oferta num canal WhatsApp e/ou grupo de ofertas como post com link preview, não como envio em massa frio para números individuais.

Canal ou chat de grupo WhatsApp num telefone a mostrar post de oferta com link preview, título, preço e link de produto afiliado.

Experiência do cliente

Seguidores veem o preview da oferta no chat

Sem automatização, um preço quente do marketplace aparece no pipeline de ingestão enquanto subscritores esperam que alguém reescreva o link de afiliado e cole um post formatado à mão.

Quando o fluxo termina, subscritores do canal e membros do grupo veem um post com link preview com título, preço e URL de rastreio para comprar. Integradores constroem este resultado com a WhatsApp API.

Fluxo de trabalho

De uma oferta de marketplace a um link preview

Oferta de marketplace qualificada

O seu backend ingere ou deteta uma oferta da Amazon, AliExpress ou fonte similar, injeta a tag de afiliado e link curto opcional e prepara título, preço e media de preview. A Whapi.Cloud não faz scrape de marketplaces nem reescreve ids de afiliado.

Resolva o id do canal uma vez

GET /newsletters

getNewsletters lista os seus canais para escolher o JID do canal de ofertas, guardá-lo no backend e omitir esta chamada em cada oferta seguinte salvo se o canal mudar.

Resolva o id do grupo de ofertas quando necessário

GET /groups

getGroups lista os seus grupos para guardar o JID do grupo de ofertas quando o fan-out para grupo está ativo — chame uma vez ou quando o grupo alvo mudar, não em cada SKU.

Publique o link preview da oferta

POST /messages/link_preview

sendMessageLinkPreview envia a URL reescrita do produto no corpo com título e media opcional para cada JID de destino configurado; repita a chamada quando canal e grupo devem receber a mesma oferta.

Ver exemplos de código

Precisa de acompanhar a entrega? Uma resposta de envio bem-sucedida não prova que seguidores já veem o post da oferta. Acompanhe acks posteriores nos webhooks de entrega. Saiba mais sobre estado de entrega →

Pré-requisitos

Antes de executar o fluxo

Ligue o número WhatsApp que administra o canal ou grupo de ofertas e autentique cada pedido com o token de API desse número. Ingestão de marketplace, reescrita de afiliado e lógica de links curtos ficam no seu backend.

1. Crie uma conta Whapi.Cloud: Registar
2. Ligue a sua conta WhatsApp: Abrir o guia
3. Encontre o seu token de API: Abrir a secção

Opcional — aprofundar neste fluxo

Visão geral da API de canais WhatsApp: Ver a visão geral
Automatizar grupos WhatsApp com a API: Abrir o guia
Visão geral da API de grupos WhatsApp: Ver a visão geral

Implementação de API

As chamadas que publicam a oferta

O seu backend já qualificou a oferta e tem a URL de afiliado reescrita. Estas chamadas resolvem JIDs de destino quando precisa e entregam o SKU como post com link preview ao canal e/ou grupo de ofertas.

Obtenha o token de API grátis após registar-se em whapi.cloud e use esse token no código em vez de Your_Token dos exemplos.

Resolva o id do canal uma vez

Liste os seus canais para guardar o JID do canal de ofertas uma vez antes dos posts começarem.

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))
}

Resolva o id do grupo de ofertas quando necessário

Liste os seus grupos para guardar o JID do grupo de ofertas quando o fan-out para grupo faz parte da configuração.

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))
}

Publique o link preview da oferta

Envie título, preço e URL reescrita a cada JID de destino guardado como anúncio com link preview por oferta qualificada.

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))
}

Obtenha a chave API grátis

Estado da entrega

Quando o post da oferta sai de pending

Uma resposta de envio bem-sucedida não significa que seguidores já têm o post da oferta. O primeiro estado visível antes de um webhook é pending. Alterações posteriores chegam só em statuses.post e statuses.put. Se o estado ficar em pending e não passar a sent, delivered ou ack posterior, a mensagem não foi entregue — verifique a carga e a permissão da conta para enviar esse tipo.

Trate um pending preso como não entregue, não como relógio ou fila à espera de webhook.
Subscreva statuses.post e statuses.put quando precisar de confirmação de envio ou entrega para posts em canal ou grupo.
Não marque a oferta de marketplace como totalmente publicada enquanto o estado WhatsApp permanecer pending.

O que ler sobre entrega e webhooks

Como é um webhook de entrega: Ver o callback
Que eventos enviamos para um webhook: Ver eventos acompanhados
Como definir webhook num canal: Abrir o guia
Onde obter o URL do webhook: Abrir o guia
Exemplos de payload de webhook: Ver os formatos

Contacte o suporte se algo correu mal

Quando algo falha

Trate falhas em cada passo

Se a oferta passou a ingestão mas a reescrita de afiliado falhou, getNewsletters ou getGroups não encontram destino, o JID guardado está errado, sendMessageLinkPreview é rejeitado numa superfície enquanto outra teve sucesso, ou o post nunca sai de pending, reintente ou alerte e não marque a oferta como totalmente publicada.

A oferta estava pronta, mas o WhatsApp ficou em silêncio?

Mantenha separado o estado da oferta de marketplace da entrega WhatsApp. Confirme saída de afiliado e link curto no backend, verifique JIDs de canal e grupo guardados, reintente sendMessageLinkPreview para o destino falhado ou alerte operações — não marque o SKU publicado enquanto seguidores não têm post. Se o post continuar a falhar após reintento, contacte o suporte Whapi com o id de destino e o id do pedido falhado.

Contacte o suporte se algo correu mal

Diagnostique por passo de API

Código	O que significa	O que fazer
`400`	Wrong request parameters	Corrija parâmetros errados na chamada de listagem de newsletters antes de reintentar.
`500`	Internal Error

Código	O que significa	O que fazer
`400`	Wrong request parameters	Corrija parâmetros errados no corpo de link preview antes de reintentar.
`401`	Need channel authorization for send message	Autorize o canal para enviar mensagens e reintente com token válido.
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Confirme que é permitido enviar para este destinatário de canal ou grupo e reintente com valor `to` corrigido.
`404`	Media with specified id not found
`413`	Request media too large
`415`	Unsupported media type
`429`	Too many requests	Reduza a velocidade e reintente mais tarde após demasiados pedidos.
`500`	Internal Error

Código	O que significa	O que fazer
`400`	Wrong request parameters	Corrija parâmetros errados na chamada de listagem de grupos antes de reintentar.
`500`	Internal Error

Perguntas frequentes

Ofertas de marketplace e publicação no WhatsApp

Não. O seu backend ingere sinais de ofertas, aplica regras de afiliado e link curto e decide quando um SKU está pronto para publicar. A Whapi.Cloud recebe o envio WhatsApp depois de chamar sendMessageLinkPreview com a URL reescrita no corpo.

Não. Resolva e guarde JIDs de destino uma vez (ou quando canal ou grupo mudar) e reutilize esses ids em posts posteriores com link preview. Listar em cada tick de oferta acrescenta latência sem mudar o cenário.

Siga o failure_mode do catálogo — não marque a oferta como totalmente publicada, reintente ou alerte e verifique saída de reescrita de afiliado, JIDs guardados, envios rejeitados ou estado que permanece pending.

Fluxos RSS para canal disparam por itens de feed e referenciam URLs de artigos CMS. Este fluxo dispara por sinais de ofertas de marketplace com URLs de afiliado e pode fazer fan-out para um grupo de ofertas além do canal.

Espelhar para Telegram ou outros mensageiros fica no seu backend. Este trabalho cobre apenas posts com link preview em canal e/ou grupo WhatsApp.

Comece com a API

Recursos compatíveis do WhatsApp

Tudo o que você precisa para criar automações no WhatsApp

O Whapi.Cloud oferece acesso a um conjunto completo de recursos do WhatsApp — mensagens, mídia, grupos, canais, webhooks e muito mais. Crie bots, automações e integrações sem limitações de funcionalidades.

Escolhido por desenvolvedores

Confiado por mais de 3.300 desenvolvedores e equipes SaaS

Desenvolvedores no mundo inteiro utilizam o Whapi.Cloud para criar automações, bots, integrações com CRM, ferramentas de envio em massa e fluxos avançados de WhatsApp. Nossa infraestrutura processa milhões de requisições API com alta estabilidade — e esse número cresce a cada mês.

5,5K+

canais de API ativos

21M+

requisições API por mês

Iniciar teste gratuito Ver todas as avaliações

“Tudo é simples, intuitivo e fácil de navegar. A documentação é clara e todas as informações estão bem à mão. Trabalho excelente.”

Roberto K. / Desenvolvedor Web

“Conectamos o WhatsApp aos nossos fluxos usando o n8n em apenas alguns minutos. Sem código, sem complicações — funcionou de primeira.”

Martin P. / Desenvolvedor

“O Whapi.Cloud se tornou uma parte essencial da nossa comunicação com clientes. Automatizamos atualizações de produtos, notificações de pedidos e mensagens de suporte — tudo sem templates nem aprovações da Meta.”

Oscar T. / CTO

Relacionados

Mais fluxos de ofertas e publicação

RSS WordPress para canal WhatsApp com link preview (irmão, não ofertas de marketplace)

Publicar texto simples num canal quando o CMS publica conteúdo (irmão, não ofertas com link preview)

API de canais WhatsApp — publicar atualizações e gerir canais

Automatizar grupos WhatsApp — fan-out para grupo de ofertas e JIDs de grupo guardados

Visão geral da API de grupos WhatsApp — listar grupos antes de publicar ofertas

Casos de estudo de automatização WhatsApp para marketplaces e comércio eletrónico

Quando usar este fluxo

Seguidores veem o preview da oferta no chat

De uma oferta de marketplace a um link preview

Antes de executar o fluxo

As chamadas que publicam a oferta

Resolva o id do canal uma vez

Resolva o id do grupo de ofertas quando necessário

Publique o link preview da oferta

Quando o post da oferta sai de pending

O que ler sobre entrega e webhooks

Trate falhas em cada passo

Diagnostique por passo de API

Liste canais e escolha o JID a guardar para posts de ofertas. getNewsletters · GET /newsletters

Publique o link preview da oferta em cada JID de destino guardado. sendMessageLinkPreview · POST /messages/link_preview

Liste grupos e escolha o JID do grupo de ofertas a guardar quando o fan-out para grupo está ativo. getGroups · GET /groups

Ofertas de marketplace e publicação no WhatsApp

A Whapi.Cloud encontra ofertas Amazon ou AliExpress por mim?

Devo chamar getNewsletters e getGroups em cada oferta?

E se a ingestão teve sucesso mas seguidores nunca viram a oferta?

Em que difere de publicar itens RSS num canal?

Posso espelhar a mesma oferta no Telegram a partir da Whapi?

Tudo o que você precisa para criar automações no WhatsApp

API de Canais do WhatsApp

Grupos e Comunidades do WhatsApp

Sem templates ou aprovações

Webhooks em tempo real

Todos os tipos de mídia e mensagens

Automação de pedidos e produtos

Validação de números do WhatsApp

Compatível com low-code e no-code

API de Status do WhatsApp

Status de entrega e leitura

Conexão multidispositivo

Mensagens interativas e botões

Confiado por mais de 3.300 desenvolvedores e equipes SaaS

5,5K+

21M+

“Tudo é simples, intuitivo e fácil de navegar. A documentação é clara e todas as informações estão bem à mão. Trabalho excelente.”

“Conectamos o WhatsApp aos nossos fluxos usando o n8n em apenas alguns minutos. Sem código, sem complicações — funcionou de primeira.”

“O Whapi.Cloud se tornou uma parte essencial da nossa comunicação com clientes. Automatizamos atualizações de produtos, notificações de pedidos e mensagens de suporte — tudo sem templates nem aprovações da Meta.”

Mais fluxos de ofertas e publicação