Uau! Construiți-vă integrarea WhatsApp. Începeți gratuit. Înregistrați-vă acum
Bun venit la intrare · caz de utilizare WhatsApp API

Mesaje de bun venit într-un grup WhatsApp când cineva intră

Noii membri pot vedea același mesaj de onboarding în chatul grupului, în privat sau în ambele, fără ca un admin să-l tasteze manual. Când un participant intră, backend-ul sau automatizarea ta mapează id-ul grupului la textul potrivit și trimite prin Whapi.Cloud. Acest caz de utilizare arată integratorilor cum implementează fluxul prin WhatsApp API.

Pornește de la webhook de intrare în grup Mesaj public în grup și/sau chat privat
Panou admin comunitate lângă un telefon al cărui chat de grup WhatsApp arată un mesaj de bun venit imediat după ce cineva a intrat.
Caz de utilizare

Când să folosești acest flux

Un webhook de intrare ar trebui să pornească bun venitul

Folosește acest flux când webhook-ul canalului livrează un eveniment de intrare a participantului în grup și worker-ul tău trebuie să reacționeze, nu când trimiți text doar la clic manual.

Rulezi mai multe grupuri cu texte de bun venit diferite

Folosește acest flux când fiecare id de grup se mapează la reguli proprii, DM privat sau ambele, nu când un singur text servește toate comunitățile.

n8n, Make sau backend-ul tău gestionează dedupe și timing

Folosește acest flux când own_backend, n8n sau Make deduplică evenimentele de intrare și alege livrarea publică sau privată, nu când aprobarea intrării încă e în așteptare.

Chat de grup WhatsApp pe telefon cu mesaj proaspăt de bun venit după ce a intrat un membru nou.
Experiența clientului

Noii membri se simt bineveniți imediat

Fără automatizare, adminii uită să salute sau lipește reguli diferite de fiecare dată, iar cei noi intră într-un grup aglomerat fără un pas clar următor.

După flux, grupul poate vedea un salut public și reguli, iar noul venit poate primi o notă privată cu linkuri sau instrucțiuni. Integratorii construiesc acest rezultat cu WhatsApp API.

Flux de lucru

De la evenimentul de intrare la bun venit

1

Un participant intră în grup

Whapi trimite un eveniment de participant al grupului la URL-ul webhook. own_backend, n8n sau Make citește id-ul grupului și al noului venit, deduplică payload-uri duplicate de intrare și încarcă textul de bun venit pentru acel grup.

2

Trimite textul de bun venit

POST /messages/text

sendMessageText publică bun venitul configurat. Pune id-ul @g.us al grupului sau chat-ul noului venit în to și mesajul în body. Apelează o dată pentru bun venit public, o dată pentru notă privată, sau de două ori când se aplică ambele.

Ai nevoie de urmărirea livrării? Un răspuns API reușit nu înseamnă că toată lumea vede deja bun venitul în chat. Află despre statusul livrării →

Cerințe preliminare

Înainte de a rula fluxul

Conectează numărul WhatsApp care administrează sau trimite în aceste grupuri, activează webhook-uri de canal pentru evenimente de participanți și autentifică fiecare trimitere cu tokenul API al acelui număr. Dedupe, text per grup și logica n8n sau Make rămân în afara Whapi.

Opțional — detalii pentru acest flux

Implementare API

Un apel livrează bun venitul

Acest apel este modul în care textul de onboarding ajunge în chatul grupului sau în chatul privat al noului venit după ce worker-ul procesează webhook-ul de intrare.

Obține tokenul API gratuit după înregistrarea pe whapi.cloud și folosește-l în cod în loc de Your_Token din exemple.

Trimite textul de bun venit

Trimite textul de bun venit configurat către grup sau participant nou, astfel onboarding-ul la intrare nu depinde 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))
}
Livrare

Știi când bun venitul a ajuns

Un răspuns de trimitere reușit nu înseamnă că destinatarul are deja mesajul de bun venit. Primul status vizibil înainte de webhook este pending. Schimbările ulterioare vin doar pe statuses.post și statuses.put. Dacă statusul rămâne pending și nu trece la sent, delivered sau alt ack, mesajul nu a fost livrat. Verifică payload-ul și permisiunea contului pentru acest tip de trimitere.

  • Un răspuns de la sendMessageText nu dovedește că bun venitul e vizibil în chat.

  • pending care nu avansează înseamnă că bun venitul nu a fost livrat.

  • Urmărește statuses.post și statuses.put pentru ack-uri ulterioare pe fiecare ramură.

  • Reîncearcă sau alertează separat când ramura publică a grupului eșuează dar cea privată reușește.

Ce să citești despre livrare și webhook-uri

Contactează suportul dacă ceva nu a mers bine
Când ceva se strică

Gestionează eșecurile la fiecare pas

Webhook-uri de intrare duplicate, JID de grup greșit în config sau bun venit respins ori nelivrat trebuie deduplicate, omise, reîncercate sau alertate, nu tratate ca onboarding finalizat.

Intrare detectată, dar bun venit eșuat?

Deduplică după id participant și id grup înainte de send. Dacă JID-ul grupului e necunoscut, loghează, sari peste send și alertează ops în loc să postezi altundeva. Când sendMessageText e respins sau nelivrat, reîncearcă cu backoff și alertează; gestionează ramurile publică și privată independent. Dacă livrarea tot eșuează după retry, contactează suportul Whapi cu id canal și răspunsul eșuat.

Contactează suportul dacă ceva nu a mers bine

Depanează pe pas API

Stare Ce înseamnă Ce să faci
400 Wrong request parameters Parametri greșiți — verifică to și body în payload-ul de bun venit.
401 Need channel authorization for send message
402 Trial version limit exceeded
403 It is forbidden to send to this group/recipient Trimiterea la acest grup sau destinatar e interzisă — confirmă JID grup, id chat noul venit și permisiunile canalului.
429 Too many requests
500 Internal Error
Întrebări frecvente

Întrebări de la integratori

Nu. Moderarea intrării aprobă sau respinge o cerere înainte ca cineva să intre. Acest flux rulează după ce participantul e deja în grup și trimite textul de bun venit.
Nu. Invite-after-payment rezolvă link de invitație pentru plătitor. Aici triggerul e eveniment de intrare și ramura e text de bun venit în grup și/sau chat privat.
Deduplică după id participant și id grup înainte de send. Tratează webhook duplicat ca onboarding incomplet până worker-ul confirmă primul send reușit.
Da. Mapează fiecare grup la modul de livrare în own_backend, n8n sau Make, apoi apelează sendMessageText cu JID grup, chat noul venit sau ambele în cereri separate.
Nu pentru acest copy personalizat de onboarding. Compui corpul și trimiți cu sendMessageText. Ține cont de regulile de șabloane doar dacă treci mai târziu la invitație sau mesaj utilitar bazat pe șablon într-un alt flux.
Funcționalități WhatsApp suportate

Tot ce ai nevoie pentru a construi automatizări pe WhatsApp

Whapi.Cloud îți oferă acces la un set complet de funcționalități WhatsApp — mesaje, media, grupuri, canale, webhook-uri și altele. Construiește boți, automatizări și integrări fără limitări de funcții.

Ales de dezvoltatori

De încredere pentru peste 3.300 de dezvoltatori și echipe SaaS

Dezvoltatori din întreaga lume se bazează pe Whapi.Cloud pentru a crea automatizări, boți, integrări CRM, instrumente de mesagerie în masă și fluxuri avansate WhatsApp. Infrastructura noastră procesează milioane de cereri API cu o stabilitate ridicată — iar numărul crește în fiecare lună.

Pictogramă funcționalitate

5,5K+

canale API active

Pictogramă funcționalitate

21M+

cereri API pe lună

„Totul este simplu, intuitiv și ușor de folosit. Documentația este clară, iar toate informațiile necesare sunt la îndemână. Foarte bine făcut.”

Roberto K. / Web Developer

„Am conectat WhatsApp la fluxurile noastre în n8n în doar câteva minute. Fără cod, fără complicații — totul a funcționat din prima.”

Martin P. / Developer

„Whapi.Cloud a devenit o parte esențială a comunicării cu clienții. Am automatizat actualizări de produse, notificări de comenzi și mesaje de suport — fără șabloane sau aprobări Meta.”

Oscar T. / CTO

Bulă decorativă