Wow! WhatsApp entegrasyonunuzu oluşturun. Ücretsiz başlayın. Şimdi Kaydol
Katılımda hoş geldin · WhatsApp API senaryosu

Birisi gruba katıldığında WhatsApp grubunda hoş geldin mesajları

Yeni üyeler aynı onboarding mesajını grup sohbetinde, özelde veya ikisinde birden görebilir; admin elle yazmak zorunda kalmaz. Katılım olduğunda backend veya otomasyonunuz grup id'sini doğru metne eşler ve Whapi.Cloud üzerinden gönderir. Bu senaryo, integrator'ların WhatsApp API ile akışı nasıl kuracağını gösterir.

Grup katılım webhook'u ile başlar Herkese açık grup mesajı ve/veya özel sohbet
Topluluk yönetim paneli ve birinin katılmasından hemen sonra hoş geldin mesajı gösteren WhatsApp grup sohbetli telefon.
Kullanım senaryosu

Bu akış ne zaman?

Katılım webhook'u hoş geldini başlatmalı

Kanal webhook'unuz grup katılım olayı ilettiğinde ve worker'ınızın tepki vermesi gerektiğinde bu akışı kullanın; yalnızca elle tıklayıp metin gönderdiğinizde değil.

Birden fazla grup, farklı hoş geldin metinleri

Her grup id'si kendi kurallarına, özel DM'e veya ikisine eşlendiğinde bu akışı kullanın; tek metin tüm topluluklara uyduğunda değil.

n8n, Make veya backend dedupe ve zamanlamayı yönetir

own_backend, n8n veya Make katılım olaylarını tekilleştirip herkese açık veya özel teslimi seçtiğinde bu akışı kullanın; katılım onayı hâlâ beklerken değil.

Telefonda yeni üye katıldıktan hemen sonra taze hoş geldin mesajı gösteren WhatsApp grup sohbeti.
Müşteri deneyimi

Yeni üyeler hemen karşılandığını hisseder

Otomasyon yoksa adminler selamlamayı unutur veya her seferinde farklı kurallar yapıştırır; yeni gelen net bir sonraki adım görmez.

Akış çalışınca grup herkese açık bir selam ve kurallar görebilir; yeni gelen özel notta link veya talimat alabilir. Integrator'lar bunu WhatsApp API ile kurar.

İş akışı

Katılım olayından hoş geldine

1

Bir katılımcı gruba katılır

Whapi grup katılımcı olayını webhook URL'nize gönderir. own_backend, n8n veya Make grup id ve yeni gelen id'sini okur, yinelenen katılım payload'larını tekilleştirir ve o grup için hoş geldin metnini yükler.

2

Hoş geldin metnini gönder

POST /messages/text

sendMessageText yapılandırılmış hoş geldini yollar. Grup @g.us id'sini veya yeni gelenin sohbet id'sini to'ya, mesajı body'ye koyun. Herkese açık hoş geldin için bir kez, özel not için bir kez veya ikisi de gerekiyorsa iki kez çağırın.

Teslimat takibi mi lazım? Başarılı API yanıtı herkesin sohbette hoş geldini gördüğü anlamına gelmez. Teslimat durumu hakkında →

Ön koşullar

Akışı çalıştırmadan önce

Bu gruplarda yöneten veya gönderen WhatsApp numarasını bağlayın, katılımcı olayları için kanal webhook'larını açın ve her gönderimi o numaranın API token'ı ile doğrulayın. Dedupe, grup başına metin ve n8n veya Make mantığı Whapi dışında kalır.

İsteğe bağlı — bu akışta derinleş

API uygulaması

Tek çağrı hoş geldini iletir

Worker katılım webhook'unu işledikten sonra onboarding metni grup sohbetine veya yeni gelenin özel sohbetine bu çağrıyla gider.

whapi.cloud'a kayıt olduktan sonra ücretsiz API token alın ve örneklerdeki Your_Token yerine kodda onu kullanın.

Hoş geldin metnini gönder

Yapılandırılmış hoş geldin metnini gruba veya yeni katılımcıya gönderin; katılım onboarding'i elle posta bağlı kalmasın.

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

Hoş geldin ulaştığında bilin

Başarılı gönderim yanıtı alıcının hoş geldin mesajına zaten sahip olduğu anlamına gelmez. Webhook öncesi ilk görünen durum pending. Sonraki değişiklikler yalnızca statuses.post ve statuses.put ile gelir. Durum pending kalıp sent, delivered veya sonraki ack'e geçmezse mesaj teslim edilmedi. Payload ve hesabın bu gönderim türü iznini kontrol edin.

  • sendMessageText yanıtı hoş geldinin sohbette göründüğünü kanıtlamaz.

  • İlerlemeyen pending hoş geldinin teslim edilmediği demektir.

  • Her bacak için sonraki ack'lerde statuses.post ve statuses.put izleyin.

  • Herkese açık grup bacağı düşerken özel bacak başarılıysa ayrı yeniden dene veya uyar.

Teslimat ve webhook okuması

Bir şey ters gittiyse desteğimize yazın
Bir şey bozulunca

Her adımda hataları yönet

Yinelenen katılım webhook'ları, yapılandırmada yanlış grup JID'i veya reddedilen/teslim edilmeyen hoş geldin tekilleştirilmeli, atlanmalı, yeniden denenmeli veya uyarılmalı; onboarding bitti sayılmamalı.

Katılım algılandı ama hoş geldin gitti mi?

Gönderimden önce katılımcı id ve grup id ile tekilleştirin. Grup JID bilinmiyorsa loglayın, atlayın ve ops uyarın; başka yere post etmeyin. sendMessageText reddedilir veya teslim edilmezse backoff ile yeniden dene ve uyar; herkese açık ve özel bacakları bağımsız ele alın. Yeniden denemeden sonra hâlâ düşerse kanal id ve hatalı yanıtla Whapi desteğine yazın.

Bir şey ters gittiyse desteğimize yazın

API adımına göre teşhis

Durum Anlamı Ne yapmalı
400 Wrong request parameters Yanlış istek parametreleri — hoş geldin payload'ında to ve body kontrol edin.
401 Need channel authorization for send message
402 Trial version limit exceeded
403 It is forbidden to send to this group/recipient Bu gruba veya alıcıya göndermek yasak — grup JID, yeni gelen sohbet id ve kanal izinlerini doğrulayın.
429 Too many requests
500 Internal Error
Sık sorulan sorular

Integrator'ların sordukları

Hayır. Katılım moderasyonu biri girmeden bekleyen isteği onaylar veya reddeder. Bu akış katılımcı zaten gruptayken çalışır ve hoş geldin metnini gönderir.
Hayır. Invite-after-payment ödeyen için davet linki çözer. Burada tetikleyici katılım olayı; dal grup ve/veya özel sohbette hoş geldin metni.
Gönderimden önce katılımcı id ve grup id ile tekilleştirin. Yinelenen webhook'u, worker ilk gönderimin başarılı olduğunu doğrulayana kadar tamamlanmamış onboarding sayın.
Evet. Her grubu own_backend, n8n veya Make'te teslim moduna eşleyin; sonra sendMessageText'i grup JID, yeni gelen sohbet id veya ikisiyle ayrı isteklerde çağırın.
Bu özel onboarding metni için hayır. Gövdeyi siz yazarsınız ve sendMessageText ile gönderirsiniz. Şablon kurallarını yalnızca başka bir akışta şablon tabanlı davet veya utility'ye geçerseniz düşünün.
Desteklenen WhatsApp Özellikleri

WhatsApp otomasyonları oluşturmak için ihtiyacınız olan her şey

Whapi.Cloud; mesajlaşma, medya, gruplar, kanallar, webhook’lar ve daha fazlası dahil olmak üzere WhatsApp’ın tüm özelliklerine erişim sağlar. Özellik kısıtlamaları olmadan botlar, otomasyonlar ve entegrasyonlar oluşturun.

Geliştiricilerin tercihi

3.300+ geliştirici ve SaaS ekibi tarafından güveniliyor

Dünya genelindeki geliştiriciler, otomasyonlar, botlar, CRM entegrasyonları, toplu mesaj araçları ve gelişmiş WhatsApp iş akışları oluşturmak için Whapi.Cloud'a güveniyor. Altyapımız her ay yüksek kararlılıkla milyonlarca API isteği işliyor — ve bu sayı giderek artıyor.

Özellik simgesi

5,5K+

aktif API kanalı

Özellik simgesi

21M+

aylık API isteği

“Her şey basit, sezgisel ve kullanımı kolay. Dokümantasyon net ve gerekli tüm bilgiler elimizin altında. Harika iş.”

Roberto K. / Web Geliştirici

“WhatsApp'ı n8n kullanarak iş akışlarımıza sadece birkaç dakikada bağladık. Kod yok, karmaşa yok — her şey ilk denemede çalıştı.”

Martin P. / Geliştirici

“Whapi.Cloud, müşteri iletişimimizin önemli bir parçası haline geldi. Ürün güncellemelerini, sipariş bildirimlerini ve destek mesajlarını Meta şablonlarına veya onaylara ihtiyaç duymadan otomatikleştirdik.”

Oscar T. / CTO

Dekoratif balon