RSS do WordPress para canal WhatsApp com a WhatsApp API

Caso de uso · API

Quando usar este fluxo

O seu backend já vigia o feed RSS

Use este fluxo quando o seu backend faz polling ou recebe um item RSS novo do WordPress (ou CMS semelhante) e esse item é a fonte de verdade do que deve aparecer no canal.

O destino é um canal WhatsApp

Use este fluxo quando os subscritores devem ver o anúncio num canal WhatsApp, não na lista de chats privados nem como convite para grupo.

A publicação deve levar o URL do artigo como pré-visualização de link

Use este fluxo quando a atualização do canal tem de incluir o link do artigo como anúncio com pré-visualização de link, não um texto colado sem esse URL.

Canal WhatsApp num telemóvel com uma publicação de pré-visualização de link com o título do artigo e um link para a história no WordPress.

Experiência do cliente

Os subscritores recebem o link do artigo no canal

Antes da automação, o artigo já está no site e no RSS, mas os subscritores do canal esperam enquanto alguém abre o WhatsApp e cola o link manualmente.

Depois do fluxo correr, os subscritores do canal veem um anúncio com pré-visualização de link com o título do artigo e um link de volta à publicação no site. Os integradores constroem este resultado com a WhatsApp API.

Fluxo de trabalho

De um item RSS a uma pré-visualização de link no canal

Item novo no feed RSS

O seu backend deteta um item novo no feed RSS do WordPress vigiado e lê o URL do artigo, o título e a imagem opcional. A Whapi.Cloud não aloja o polling do feed.

Resolva o id do canal uma vez

GET /newsletters

getNewsletters devolve a lista dos seus canais para escolher o JID do canal alvo, guardá-lo no backend e saltar esta chamada em cada item RSS seguinte, salvo se o canal mudar.

Publique a pré-visualização de link do artigo

POST /messages/link_preview

sendMessageLinkPreview publica o anúncio no JID do canal guardado com o URL do artigo no corpo e o título para o cartão de pré-visualização.

Ver exemplos de código

Precisa de acompanhar a entrega? Uma resposta de envio bem-sucedida não prova que os subscritores já veem a publicação no canal. Acompanhe acks posteriores nos webhooks de entrega. Saiba mais sobre o estado de entrega →

Pré-requisitos

Antes de executar o fluxo

Ligue o número WhatsApp que administra o canal e autentique cada pedido com o token API desse número. A vigilância do RSS e o parsing do feed WordPress ficam no seu backend.

1. Crie uma conta Whapi.Cloud: Registe-se
2. Ligue a sua conta WhatsApp: Abra o guia
3. Encontre o seu token API: Abra a secção

Opcional — aprofunde neste fluxo

Visão geral da API de canais WhatsApp: Ver a visão geral

Implementação da API

As chamadas que publicam o artigo

O seu backend já encontrou o item RSS novo e sabe que canal deve recebê-lo. Estas chamadas resolvem o id do canal quando precisa e entregam o artigo como anúncio com pré-visualização de link.

Obtenha o token 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 alvo uma vez antes de os items RSS começarem a publicar.

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

Publique a pré-visualização de link do artigo

Envie o título e o URL do artigo para o JID do canal guardado como anúncio com pré-visualização de link por cada item RSS novo.

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": "New article on the site",
  "body": "Fresh from our blog: https://example.com/blog/new-post",
  "media": "https://example.com/blog/new-post-cover.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" => "New article on the site",
    "body" => "Fresh from our blog: https://example.com/blog/new-post",
    "media" => "https://example.com/blog/new-post-cover.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": "New article on the site",
  "body": "Fresh from our blog: https://example.com/blog/new-post",
  "media": "https://example.com/blog/new-post-cover.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: 'New article on the site',
    body: 'Fresh from our blog: https://example.com/blog/new-post',
    media: 'https://example.com/blog/new-post-cover.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\":\"New article on the site\",\"body\":\"Fresh from our blog: https://example.com/blog/new-post\",\"media\":\"https://example.com/blog/new-post-cover.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 = "New article on the site",
  body = "Fresh from our blog: https://example.com/blog/new-post",
  media = "https://example.com/blog/new-post-cover.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":"New article on the site","body":"Fresh from our blog: https://example.com/blog/new-post","media":"https://example.com/blog/new-post-cover.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 API KEY grátis

Estado da entrega

Quando a publicação no canal deixa de estar pending

Uma resposta de envio bem-sucedida não significa que os subscritores do canal já têm a publicação. O primeiro estado visível antes de um webhook é pending. Alterações posteriores chegam apenas em statuses.post e statuses.put. Se o estado permanecer em pending e não avançar para sent, delivered ou um ack posterior, a mensagem não foi entregue — verifique o payload e a permissão da conta para enviar esse tipo.

Trate um pending preso como não entregue, não como relógio nem fila à espera de webhook.
Subscreva statuses.post e statuses.put quando precisar de confirmação de envio ou entrega da publicação no canal.
Não marque o item RSS como sincronizado enquanto o estado WhatsApp estiver em 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 um 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 nosso suporte se algo correu mal

Quando algo falha

Trate falhas em cada passo

Se o item RSS é novo mas getNewsletters não encontra um canal, guardou um JID errado, sendMessageLinkPreview é rejeitado ou a publicação não sai de pending, tente de novo ou alerte operações e não marque o item do feed como sincronizado com o canal.

O feed atualizou, mas o canal ficou em silêncio?

Mantenha o estado do item RSS separado da entrega no canal. Confirme o JID guardado, volte a sendMessageLinkPreview com o URL do artigo no corpo ou alerte operações — não marque o item como sincronizado enquanto os subscritores não virem a publicação. Se a publicação no canal continuar a falhar após nova tentativa, contacte o suporte Whapi com o id do canal e o id do pedido falhado.

Contacte o nosso suporte se algo correu mal

Diagnostique por passo da API

Código	O que significa	O que fazer
`400`	Wrong request parameters	Corrija parâmetros errados no pedido de listagem de newsletters antes de tentar de novo.
`500`	Internal Error

Código	O que significa	O que fazer
`400`	Wrong request parameters	Corrija parâmetros errados no corpo da pré-visualização de link antes de tentar de novo.
`401`	Need channel authorization for send message	Autorize o canal para enviar mensagens e tente de novo com um token válido.
`402`	Trial version limit exceeded
`403`	It is forbidden to send to this group/recipient	Confirme que pode enviar para este destinatário do canal e tente de novo com um 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 cadência e tente mais tarde após demasiados pedidos.
`500`	Internal Error

Perguntas frequentes

Itens RSS e publicações no canal WhatsApp

Não. O seu backend vigia o feed e decide quando um item é novo. A Whapi.Cloud recebe a publicação no canal depois de chamar sendMessageLinkPreview com o URL do artigo.

Não. Chame uma vez (ou quando o canal alvo mudar), guarde o JID do canal do seu lado e reutilize esse id nas publicações seguintes com pré-visualização de link.

Trate como o modo de falha do catálogo — não marque o item RSS como sincronizado, tente de novo ou alerte e verifique se getNewsletters correspondeu ao canal certo ou se sendMessageLinkPreview foi rejeitado ou ficou em pending.

Não. O fluxo irmão publica texto preparado num evento genérico de publicação. Este fluxo é acionado pela deteção de um item RSS e envia um anúncio com pré-visualização de link que inclui o URL do artigo.

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 canais e publicação

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

Publicar texto simples num canal quando o conteúdo CMS fica online (irmão, não pré-visualização RSS)

Casos de operações de negócio com entrega WhatsApp impulsionada por RSS

Modelo evento → reação — gatilho entrante, envio REST de saída

Formatos de payload de webhooks entrantes, incluindo estados de entrega

Tutorial de bot WhatsApp em PHP (stack amigável ao WordPress)

Obter mensagens de canais via webhooks ou API de mensagens de newsletter

Guia Make.com — vigiar feeds ou horários e depois envios de canal Whapi

Quando usar este fluxo

Os subscritores recebem o link do artigo no canal

De um item RSS a uma pré-visualização de link no canal

Antes de executar o fluxo

As chamadas que publicam o artigo

Resolva o id do canal uma vez

Publique a pré-visualização de link do artigo

Quando a publicação no canal deixa de estar pending

O que ler sobre entrega e webhooks

Trate falhas em cada passo

Diagnostique por passo da API

Liste os canais e escolha o JID a guardar no backend. getNewsletters · GET /newsletters

Publique a pré-visualização de link do artigo no JID do canal guardado. sendMessageLinkPreview · POST /messages/link_preview

Itens RSS e publicações no canal WhatsApp

A Whapi.Cloud faz polling do feed RSS do WordPress por mim?

Devo chamar getNewsletters em cada item RSS novo?

E se o feed atualizou mas o canal nunca mostrou o artigo?

É o mesmo que publicar texto simples quando o CMS publica?

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 canais e publicação