¡Guau! Crea tu integración de WhatsApp. Empieza gratis. Regístrate ahora
Bienvenida al unirse · caso de uso WhatsApp API

Mensajes de bienvenida en un grupo de WhatsApp cuando alguien entra

Los nuevos miembros pueden ver el mismo mensaje de onboarding en el chat del grupo, en privado o en ambos, sin que un admin lo escriba a mano. Cuando entra un participante, tu backend o automatización puede mapear el id del grupo al texto correcto y enviarlo con Whapi.Cloud. Este caso de uso muestra a integradores cómo implementar ese flujo con la WhatsApp API.

Se dispara con un webhook de entrada al grupo Mensaje público en el grupo y/o chat privado
Panel de admin de comunidad junto a un teléfono cuyo chat de grupo WhatsApp muestra un mensaje de bienvenida justo después de que alguien entró.
Caso de uso

Cuándo usar este flujo

Un webhook de entrada debe iniciar la bienvenida

Usa este flujo cuando el webhook del canal entrega un evento de entrada de participante al grupo y tu worker debe reaccionar, no cuando solo envías texto con un clic manual.

Gestionas varios grupos con textos de bienvenida distintos

Usa este flujo cuando cada id de grupo se mapea a sus propias reglas, un DM privado o ambos, no cuando un mismo texto sirve para todas las comunidades.

n8n, Make o tu backend controlan dedupe y timing

Usa este flujo cuando own_backend, n8n o Make deduplican eventos de entrada y eligen entrega pública o privada, no cuando la aprobación de entrada sigue pendiente.

Chat de grupo WhatsApp en un teléfono con un mensaje de bienvenida recién después de que entró un miembro.
Experiencia del cliente

Los nuevos miembros se sienten bienvenidos al instante

Sin automatización, los admins olvidan saludar o pegan reglas distintas cada vez, y quien entra no sabe cuál es el siguiente paso.

Tras el flujo, el grupo puede ver un saludo público y reglas mientras el recién llegado recibe una nota privada con enlaces o instrucciones. Los integradores construyen este resultado con la WhatsApp API.

Flujo de trabajo

Del evento de entrada a la bienvenida

1

Un participante entra al grupo

Whapi envía un evento de participante del grupo a la URL de tu webhook. own_backend, n8n o Make lee el id del grupo y del recién llegado, deduplica payloads duplicados de entrada y carga el texto de bienvenida de ese grupo.

2

Enviar el texto de bienvenida

POST /messages/text

sendMessageText publica la bienvenida configurada. Pon el id @g.us del grupo o el chat del recién llegado en to y el mensaje en body. Llama una vez para bienvenida pública, una para nota privada, o dos veces si aplican ambas.

¿Necesitas seguimiento de entrega? Una respuesta exitosa de la API no significa que todos ya vean la bienvenida en el chat. Aprende sobre el estado de entrega →

Requisitos previos

Antes de ejecutar el flujo

Conecta el número de WhatsApp que administra o envía en estos grupos, activa webhooks del canal para eventos de participantes y autentica cada envío con el token API de ese número. La deduplicación, el texto por grupo y la lógica de n8n o Make quedan fuera de Whapi.

Opcional — profundizar en este flujo

Implementación API

Una llamada entrega la bienvenida

Esta llamada es cómo el texto de onboarding llega al chat del grupo o al chat privado del recién llegado después de que tu worker procesa el webhook de entrada.

Obtén tu token API gratis tras registrarte en whapi.cloud y úsalo en el código en lugar de Your_Token de los ejemplos.

Enviar el texto de bienvenida

Envía el texto de bienvenida configurado al grupo o al nuevo participante para que el onboarding al entrar no dependa de un post manual.

curl --request POST \
     --url https://gate.whapi.cloud/messages/text \
     --header 'accept: application/json' \
     --header 'authorization: Bearer Your_Token' \
     --header 'content-type: application/json' \
     --data '
{
  "to": "[email protected]",
  "body": "Welcome to the group! Read the rules below and say hello."
}
'
$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://gate.whapi.cloud/messages/text",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => "{\"to\":\"[email protected]\",\"body\":\"Welcome to the group! Read the rules below and say hello.\"}",
  CURLOPT_HTTPHEADER => [
    "accept: application/json",
    "authorization: Bearer Your_Token",
    "content-type: application/json"
  ],
]);

$response = curl_exec($curl);
curl_close($curl);
echo $response;
import requests

url = "https://gate.whapi.cloud/messages/text"
payload = {
    "to": "[email protected]",
    "body": "Welcome to the group! Read the rules below and say hello."
}
headers = {
    "accept": "application/json",
    "authorization": "Bearer Your_Token",
    "content-type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
const response = await fetch('https://gate.whapi.cloud/messages/text', {
  method: 'POST',
  headers: {
    accept: 'application/json',
    authorization: 'Bearer Your_Token',
    'content-type': 'application/json',
  },
  body: JSON.stringify({
    to: '[email protected]',
    body: 'Welcome to the group! Read the rules below and say hello.',
  }),
});

console.log(await response.text());
OkHttpClient client = new OkHttpClient();

MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\"to\":\"[email protected]\",\"body\":\"Welcome to the group! Read the rules below and say hello.\"}");
Request request = new Request.Builder()
  .url("https://gate.whapi.cloud/messages/text")
  .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/text");
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 = "[email protected]", body = "Welcome to the group! Read the rules below and say hello." });
var response = await client.PostAsync(request);

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

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

func main() {
	body := []byte(`{"to":"[email protected]","body":"Welcome to the group! Read the rules below and say hello."}`)
	req, _ := http.NewRequest("POST", "https://gate.whapi.cloud/messages/text", 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))
}
Entrega

Saber cuándo la bienvenida llegó

Una respuesta de envío exitosa no significa que el destinatario ya tenga el mensaje de bienvenida. El primer estado visible antes de un webhook es pending. Los cambios posteriores llegan solo en statuses.post y statuses.put. Si el estado permanece en pending y no pasa a sent, delivered u otro ack, el mensaje no se entregó. Revisa el payload y el permiso de la cuenta para enviar ese tipo.

  • Una respuesta de sendMessageText no prueba que la bienvenida sea visible en el chat.

  • pending que no avanza significa que la bienvenida no se entregó.

  • Observa statuses.post y statuses.put para acks posteriores en cada rama.

  • Reintenta o alerta por separado cuando falla la rama pública del grupo pero la privada tuvo éxito.

Qué leer sobre entrega y webhooks

Contacta a nuestro soporte si algo salió mal
Cuando algo falla

Gestiona fallos en cada paso

Webhooks de entrada duplicados, un JID de grupo incorrecto en la config o una bienvenida rechazada o no entregada deben deduplicarse, omitirse, reintentarse o alertarse en lugar de dar el onboarding por terminado.

¿Entrada detectada, pero falló la bienvenida?

Deduplica por id de participante e id de grupo antes del envío. Si el JID del grupo es desconocido, registra, omite y alerta a ops en lugar de publicar en otro sitio. Cuando sendMessageText se rechaza o no se entrega, reintenta con backoff y alerta; gestiona las ramas pública y privada de forma independiente. Si la entrega sigue fallando tras un reintento, contacta al soporte de Whapi con el id del canal y la respuesta fallida.

Contacta a nuestro soporte si algo salió mal

Diagnóstico por paso de API

Estado Qué significa Qué hacer
400 Wrong request parameters Parámetros de solicitud incorrectos — revisa to y body en el payload de bienvenida.
401 Need channel authorization for send message
402 Trial version limit exceeded
403 It is forbidden to send to this group/recipient Está prohibido enviar a este grupo o destinatario — confirma el JID del grupo, el id del chat del recién llegado y los permisos del canal.
429 Too many requests
500 Internal Error
Preguntas frecuentes

Preguntas de integradores

No. La moderación de entrada aprueba o rechaza una solicitud pendiente antes de que alguien entre. Este flujo corre cuando el participante ya está en el grupo y envía el texto de bienvenida.
No. Invite-after-payment resuelve un enlace de invitación para el pagador. Aquí el trigger es un evento de entrada y la rama es texto de bienvenida en el grupo y/o chat privado.
Deduplica por id de participante e id de grupo antes de llamar a send. Trata un webhook duplicado como onboarding incompleto hasta que tu worker confirme que el primer envío tuvo éxito.
Sí. Mapea cada grupo al modo de entrega en own_backend, n8n o Make, luego llama a sendMessageText con el JID del grupo, el chat del recién llegado o ambos en solicitudes separadas.
No para este copy de onboarding personalizado. Redactas el cuerpo de bienvenida y lo envías con sendMessageText. Ten en cuenta reglas de plantillas solo si más adelante cambias a invitación o mensaje de utilidad basado en plantilla en otro flujo.
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.

Icono de característica

5,5K+

canales API activos

Icono de característica

21M+

solicitudes API al mes

“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

Burbuja decorativa