Whapi.Cloud'un (WhatsApp Business API sağlayıcısı) hazırladığı bu adım adım entegrasyon rehberi; WhatsApp sipariş bildirimleri eklemek isteyen ve konektör aboneliğine gerek duymayan Brezilya Yampi mağazalarındaki Node.js ve Python geliştiricileri ile teknik yöneticiler için yazılmıştır. Yampi'nin yerel bir WhatsApp bildirim kanalı yoktur. Bunu eklemek için Yampi'nin webhook'larını Whapi.Cloud REST API'sini çağıran bir sunucuya yönlendirin: /messages/text adresine yapılan tek bir HTTP POST, mesajı bir saniyenin altında alıcının WhatsApp'ına iletir. Bu rehber HMAC-SHA256 imza doğrulamasını, tüm altı Yampi webhook olay türünü, Node.js/Express ve Python/Flask'ta çalışan kodu, Make, n8n ve Zapier üzerinden kodsuz bir yolu ve NI, Pluga ve Interakt dahil kapalı platformlarla karşılaştırmayı kapsamaktadır. WhatsApp Flows, Meta Cloud API entegrasyonu veya WABA kurulumunu kapsamaz.
TL;DR: Bu rehberden ne elde edeceksiniz
- HMAC-SHA256 doğrulamalı Node.js ve Python'da tam çalışan webhook handler'ları
- WhatsApp mesaj şablonlarıyla eşlenmiş 6 Yampi webhook olayı
/messages/textadresine tek HTTP POST ile WhatsApp mesajı gönderilir, konektör ücreti yok- Geliştiriciler için Make, n8n veya Zapier üzerinden kodsuz yol
- 8 kriterde REST API ile kapalı platformlar (NI, Pluga, Interakt) karşılaştırması
- LGPD opt-in gereksinimleri ve E.164 telefon formatı açıklamaları
Yampi'nin Yerel WhatsApp Entegrasyonu Var mı?
Hayır — bu durum pek çok Yampi mağazası sahibini hazırlıksız yakalıyor. Yampi, webhook sistemi bulunan sağlam bir Brezilya e-ticaret platformudur; ancak yerleşik bir WhatsApp bildirim kanalıyla gelmiyor.
Pluga ve NI gibi konektör araçlar bu boşluğun bir kısmını dolduruyor; ancak mesaj başına ücret alıyor ya da sizi sabit bir şablon setiyle sınırlıyor — anlamlı herhangi bir sipariş hacminde, sepet kurtarma kampanyaları hızla kârsız hale geliyor.
Doğrudan yol, Yampi'nin webhook sistemi ile Whapi.Cloud REST API'sinin birleşimidir. Yampi, anlamlı bir sipariş olayı gerçekleştiğinde sunucunuza bir HTTP POST gönderir. Sunucunuz isteği doğrular, payload'ı okur ve Whapi.Cloud'un /messages/text endpoint'ine tek bir HTTP POST gönderir. Alıcı bir saniyenin altında WhatsApp mesajını alır. Aracı aboneliği yok, mesaj başına ücret yok, vendor lock-in yok.
Açılma oranlarının önemi: WhatsApp otomasyonu yaklaşık %98 açılma oranına ulaşırken e-postada bu oran %20–25 düzeyindedir. Günde 500 sipariş bildirimi gönderen bir Brezilya mağazası için bu, e-postaya kıyasla günde yaklaşık 390 daha fazla okunan mesaj demektir — müşteri memnuniyeti ve tekrar satın alma oranlarında somut bir fark.
Whapi.Cloud, WhatsApp Web'in kullandığı mekanizmayla aynı olan web-session soketleri aracılığıyla bağlanan bir WhatsApp Business API sağlayıcısıdır. Brezilya'daki geliştiriciler ve ajanslar onu özellikle mesaj başına ücret almaması ve mevcut WhatsApp numarasıyla çalışması nedeniyle tercih etmektedir.
Yampi Mağazanız İçin WhatsApp Neden Önemli?
Brezilya, büyük e-ticaret pazarları arasında en yüksek WhatsApp penetrasyonuna sahiptir. Akıllı telefon kullanıcılarının %99'undan fazlası uygulamayı yüklü olarak kullanmaktadır. E-posta gelen kutuları günde yüzlerce mesajla rekabet ederken WhatsApp konuşmaları kişisel ve anlıktır.
| Kanal | Açılma Oranı | Yanıt Oranı | Tipik Maliyet Modeli |
|---|---|---|---|
| WhatsApp (otomatik) | ~%98 | %40–60 | Aylık sabit (Whapi.Cloud) |
| E-posta | %20–25 | %2–5 | Gönderim başına veya sabit |
| SMS | %75–85 | %15–25 | Mesaj başına |
| Push bildirimi | %10–15 | %1–3 | Aylık sabit |
Sepet kurtarma açısından ROI hesabı nettir: WhatsApp ile gönderilen sepet hatırlatıcısı neredeyse her alıcıya ulaşır; aynı mesaj e-posta yoluyla beşte birine ulaşır. Gerçek sipariş hacminde gelir farkı, entegrasyon maliyetini ilk hafta içinde karşılar.
Yampi'den WhatsApp'a otomasyon altı yaşam döngüsü aşamasını kapsar: sipariş onayı, ödeme başarısızlığı kurtarma, kargo güncellemeleri, teslim onayı, yorum talebi ve üst satış. Her aşama ayrı bir Yampi webhook olayıyla eşlenir; tümü tek bir sunucu endpoint'inden yönetilir.
Entegrasyon Nasıl Çalışır
Mimari üç bileşenden oluşur: Yampi'nin webhook sistemi, sunucunuz (veya kodsuz bir araç) ve Whapi.Cloud REST API'si. Araya giren konektör platformu yoktur.
Olaydan tepkiye akış şu şekilde işler:
- Yampi bir webhook tetikler. Alıcı ödeme yaptığında, sepetini terk ettiğinde veya sipariş durumu değiştiğinde Yampi, yapılandırılmış webhook URL'nize JSON payload ve HMAC-SHA256 imza başlığı içeren bir HTTP POST gönderir.
- Sunucunuz imzayı doğrular. Her Yampi webhook'u,
x-yampi-hmac-sha256başlığında HMAC-SHA256 imzası içerir. İşlemeden önce sunucu tarafında doğrulayın. Bu adımı atlarsanız sahte istekler, rastgele alıcılara mesaj gönderilmesini tetikleyebilir. - Sunucunuz olay türünü ve payload'ı okur.
eventalanı tetikleyiciyi tanımlar.resourcenesnesi müşteri telefonu, adı, sipariş numarası ve olaya özgü verileri içerir. - Sunucunuz Whapi.Cloud'a tek bir HTTP POST gönderir: E.164 formatında telefon numarası ve mesaj gövdesiyle
https://gate.whapi.cloud/messages/textadresine tek bir POST. Whapi.Cloud mesajı bir saniyenin altında alıcının WhatsApp'ına iletir. - Yampi 200 OK alır. Zaman aşımını önlemek için hemen yanıt verin, ardından payload'ı eş zamansız olarak işleyin.
E.164 formatı zorunludur. Whapi.Cloud, telefon numaralarını E.164 formatında gerektirir. Brezilya için: +5511999998888. Eksik ülke kodu, Yampi tarafında herhangi bir hata oluşturmadan mesaj teslimini sessizce bozar. Göndermeden önce Yampi payload'ından gelen telefon numarasını her zaman normalleştirin.
Yampi Webhook Olayları Tam Referansı
Yampi, siparişin tüm yaşam döngüsünü kapsayan altı webhook olayı sunar. Her birinin net bir tetikleyicisi, öngörülebilir bir payload yapısı ve eşleşen doğal bir WhatsApp mesajı vardır.
| Olay | Ne zaman tetiklenir | Temel payload alanları | Önerilen WhatsApp şablonu |
|---|---|---|---|
order.created |
Alıcı sipariş verir (ödemeden önce) | number, customer.phone, customer.name, checkout_url |
«Merhaba [name]! #[id] siparişiniz alındı. Onaylamak için ödemeyi tamamlayın: [link]» |
order.paid |
Ödeme onaylandı, anında tetiklenir | number, customer.phone, customer.name, total |
«Merhaba [name]! ✅ #[id] sipariş onaylandı. Hazırlanıyor. Alışverişiniz için teşekkürler!» |
order.status.updated |
Sipariş durumu değişir (örn. kargoya verildi, teslim edildi) | number, status, customer.phone, tracking_url |
«Merhaba [name]! #[id] sipariş durumu: [status]. Takip edin: [link]» |
transaction.payment.refused |
Ödeme girişimi reddedildi | number, customer.phone, checkout_url, reason |
«Merhaba [name], #[id] siparişinizin ödemesi reddedildi. Tekrar deneyin: [link]» |
cart.reminder |
Alıcı sepeti terk etti (yapılandırılmış gecikme) | customer.phone, customer.name, checkout_url, items |
«Merhaba [name]! Sepetinizde ürünler kaldı 🛒 Siparişi tamamlayın: [link]» |
order.cancellation |
Sipariş iptal edildi (mağaza veya alıcı tarafından) | number, customer.phone, reason |
«Merhaba [name], #[id] siparişiniz iptal edildi. Yardıma ihtiyacınız varsa yanıtlayın.» |
order.paid'e öncelik verin — ödeme onaylandığı anda tetiklenir. Alıcı hâlâ aktifken WhatsApp onayını hemen gönderin. Bu temas noktası, listedeki diğer tüm olaylardan daha fazla müşteri memnuniyeti yaratır ve gelen destek talebi sayısını azaltır.
Adım Adım Entegrasyon Rehberi
Bu bölüm sizi yaklaşık iki saatte sıfırdan çalışan bir webhook sunucusuna götürür. Node.js sürümü temel referanstır; Python eşdeğeri 5. Adımda yer almaktadır.
Adım 1: Ön Gereksinimler
Tek satır kod yazmadan önce şunlara ihtiyacınız var:
- Webhook erişimi olan bir Yampi mağazası (ücretli planlarda mevcuttur)
- Whapi.Cloud hesabı: ücretsiz sandbox'a kayıt olun (üretim numarası olmadan test mesajları göndermenizi sağlar)
- Whapi.Cloud kanal token'ınız (bir kanal oluşturduktan sonra panelden alınır)
- Webhook'unuz için herkese açık HTTPS URL'i (yerel test için ngrok kullanın; 6. Adımda ele alınmaktadır)
- Node.js 18+ veya Python 3.9+ kurulu
Adım 2: Yampi Panosunda Webhook'u Yapılandırma
- Yampi yönetici panelinize giriş yapın ve Ayarlar → Webhook'lar bölümüne gidin
- Webhook Ekle'ye tıklayın ve sunucu URL'nizi girin (örn.
https://yourdomain.com/webhook/yampi) - İstediğiniz olayları seçin:
order.created,order.paid,order.status.updated,transaction.payment.refused,cart.reminder,order.cancellation - Yampi'nin oluşturduğu Gizli Anahtarı kopyalayın. HMAC doğrulaması için hemen
.envdosyanızaYAMPI_WEBHOOK_SECRETolarak kaydedin. - Webhook'u kaydedin. Yampi URL'nize test ping'i gönderecektir. Sunucunuz 200 OK döndürmelidir.
Adım 3: HMAC-SHA256 Doğrulamalı Node.js Webhook Sunucusu
Bu, üretime hazır tam sunucudur. Önce bağımlılıkları kurun: npm install express axios dotenv.
// .env: YAMPI_WEBHOOK_SECRET, WHAPI_TOKEN, PORT
require('dotenv').config();
const express = require('express');
const crypto = require('crypto');
const axios = require('axios');
const app = express();
// Capture raw body for HMAC verification
app.use(express.json({
verify: (req, res, buf) => { req.rawBody = buf; }
}));
const WHAPI_BASE = 'https://gate.whapi.cloud';
// Normalize Brazilian phone to E.164: +5511999998888
function toE164(phone) {
const digits = phone.replace(/\D/g, '');
return digits.startsWith('55') ? `+${digits}` : `+55${digits}`;
}
// Send a WhatsApp text message via Whapi.Cloud
async function sendWhatsApp(phone, text) {
const to = toE164(phone); // E.164 required — e.g. +5511999998888
await axios.post(`${WHAPI_BASE}/messages/text`, { to, body: text }, {
headers: { Authorization: `Bearer ${process.env.WHAPI_TOKEN}` }
});
}
// Yampi webhook: validate HMAC-SHA256 signature, then route event
app.post('/webhook/yampi', (req, res) => {
const sig = req.headers['x-yampi-hmac-sha256'];
const expected = crypto
.createHmac('sha256', process.env.YAMPI_WEBHOOK_SECRET)
.update(req.rawBody)
.digest('base64');
if (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(expected))) {
return res.status(401).send('Invalid signature');
}
res.status(200).send('OK'); // Acknowledge immediately
const { event, resource } = req.body;
const phone = resource?.customer?.phone;
const name = resource?.customer?.name?.split(' ')[0] || 'there';
const orderId = resource?.number;
switch (event) {
case 'order.paid':
sendWhatsApp(phone,
`Hi ${name}! ✅ Order #${orderId} confirmed. We're preparing it now. Thanks for shopping with us!`);
break;
case 'order.created':
sendWhatsApp(phone,
`Hi ${name}! We received order #${orderId}. Complete payment to confirm. Questions? Reply here.`);
break;
case 'order.status.updated':
sendWhatsApp(phone,
`Hi ${name}! Order #${orderId} status updated: ${resource?.status}. Track it in your email.`);
break;
case 'transaction.payment.refused':
sendWhatsApp(phone,
`Hi ${name}, your payment for order #${orderId} was declined. Try again: ${resource?.checkout_url}`);
break;
case 'cart.reminder':
sendWhatsApp(phone,
`Hi ${name}! You left items in your cart 🛒 Complete your order: ${resource?.checkout_url}`);
break;
case 'order.cancellation':
sendWhatsApp(phone,
`Hi ${name}, order #${orderId} was cancelled. Need help? Reply and we'll sort it out.`);
break;
}
});
app.listen(process.env.PORT || 3000, () => console.log('Webhook server running'));
Kritik: HMAC için ham gövde. HMAC-SHA256 doğrulaması, ayrıştırılmış bir JSON nesnesi değil, Yampi'nin gönderdiği tam ham baytları gerektirir. express.json()'daki verify callback'i, Express parse etmeden önce ham buffer'ı yakalar. Bunun yerine ayrıştırılmış gövdeyi yeniden serileştirmeye çalışırsanız imza hiçbir zaman eşleşmez.
Adım 4: Whapi.Cloud /messages/text Üzerinden WhatsApp Gönderimi
sendWhatsApp fonksiyonu tek bir iş yapar: üç alanla https://gate.whapi.cloud/messages/text adresine POST:
to: E.164 formatında telefon (örn.+5511999998888); ülke kodu eksikliği mesaj teslimini sessizce bozarbody: mesaj metniAuthorization: Bearer YOUR_TOKEN: başlıkta Whapi.Cloud kanal token'ınız
Whapi.Cloud, Yampi mağazalarına tam mesaj kontrolü ve kanal başına aylık sabit fiyat sunar. Mesaj başına ücret yok, şablon onay süreci yok, vendor lock-in yok — NI, Pluga ve Interakt'ın aksine bunlar teslim başına ücret alır veya sizi önceden tanımlanmış şablonlarla sınırlar.
Adım 5: Python Eşdeğeri
Bağımlılıkları kurun: pip install flask requests. Mantık aynıdır: imzayı doğrula, olayı yönlendir, mesaj gönder.
import os, hmac, hashlib, base64, requests
from flask import Flask, request, abort
app = Flask(__name__)
WHAPI_TOKEN = os.getenv('WHAPI_TOKEN')
WEBHOOK_SECRET = os.getenv('YAMPI_WEBHOOK_SECRET')
def to_e164(phone):
digits = ''.join(filter(str.isdigit, phone))
return f"+{digits}" if digits.startswith('55') else f"+55{digits}"
def send_whatsapp(phone, text):
# to must be E.164 format: +5511999998888
requests.post('https://gate.whapi.cloud/messages/text',
json={'to': to_e164(phone), 'body': text},
headers={'Authorization': f'Bearer {WHAPI_TOKEN}'})
@app.route('/webhook/yampi', methods=['POST'])
def yampi_webhook():
sig = request.headers.get('X-Yampi-Hmac-Sha256', '')
expected = hmac.new(WEBHOOK_SECRET.encode(), request.get_data(), hashlib.sha256).digest()
if not hmac.compare_digest(sig, base64.b64encode(expected).decode()):
abort(401)
data = request.json
event = data.get('event')
res = data.get('resource', {})
phone = res.get('customer', {}).get('phone', '')
name = res.get('customer', {}).get('name', 'there').split()[0]
order_id = res.get('number', '')
msgs = {
'order.paid': f"Hi {name}! ✅ Order #{order_id} confirmed. We're on it!",
'order.created': f"Hi {name}! Order #{order_id} received. Complete payment to confirm.",
'order.status.updated': f"Hi {name}! Order #{order_id} status: {res.get('status')}",
'transaction.payment.refused':f"Hi {name}, payment declined for #{order_id}. Retry: {res.get('checkout_url')}",
'cart.reminder': f"Hi {name}! Your cart is waiting 🛒 {res.get('checkout_url')}",
'order.cancellation': f"Hi {name}, order #{order_id} cancelled. Reply if you need help.",
}
if event in msgs:
send_whatsapp(phone, msgs[event])
return 'OK', 200
if __name__ == '__main__':
app.run(port=int(os.getenv('PORT', 3000)))
Adım 6: ngrok ile Test ve Üretime Dağıtım
Yerel geliştirme için sunucunuzu ngrok ile dışarıya açın:
npx ngrok http 3000
Oluşturulan HTTPS URL'ini (örn. https://abc123.ngrok.io) kopyalayın ve Yampi'nin webhook yapılandırmasına yapıştırın. Yampi sandbox modunda test siparişi oluşturun. Webhook'un sunucunuza ulaştığını ve test numaranızda WhatsApp mesajının göründüğünü görmelisiniz.
Üretim için HTTPS'li herhangi bir Node.js veya Python sunucusu kullanın: Railway, Render, Fly.io, nginx'li VPS veya serverless fonksiyon (Vercel, AWS Lambda). Temel gereksinim, Yampi'nin zaman aşımı penceresi içinde 200 döndüren, herkese açık HTTPS endpoint'idir.
Kodsuz Yol: Make ve n8n
Sunucu gerekmez. Make (eski adıyla Integromat) ve n8n, Yampi webhook'larını kodsuz olarak Whapi.Cloud'a bağlar. Kurulum 30–60 dakika sürer ve hosting gerektirmez.
Her iki araçtaki desen aynıdır: Webhook tetikleyicisi Yampi olayını alır, event alanına göre yönlendirirsiniz, ardından HTTP POST modülü Bearer token'ınızla https://gate.whapi.cloud/messages/text adresine gönderir. Telefon numarasının E.164 formatına normalleştirilmesi ara adımda gerçekleşir.
Make (eski adıyla Integromat)
- Bir Webhooks → Custom Webhook tetikleyicisi ekleyin. URL'yi Yampi'nin webhook ayarlarına kopyalayın.
- Olay türü başına bir filtre içeren bir Router modülü ekleyin (
event = order.paidvb.). - Her filtreden sonra bir HTTP → Make a Request modülü ekleyin:
https://gate.whapi.cloud/messages/textadresine POST, JSON gövde{"to": "{{phone}}", "body": "{{message}}"}, Whapi.Cloud token'ınızla Yetkilendirme başlığı. - Telefonu E.164'e normalleştirmek için Make'in metin fonksiyonlarını kullanın. Adım adım açıklama için Whapi.Cloud Make entegrasyon rehberine bakın.
n8n
- Bir Webhook tetikleyici node'u ekleyin. Yolu
/yampiolarak ayarlayın ve URL'yi Yampi'ye yapıştırın. {{ $json.event }}üzerinden yönlendiren bir Switch node'u ekleyin.- Her dal için bir HTTP Request node'u ekleyin:
https://gate.whapi.cloud/messages/textadresine POST,tovebodyiçeren JSON gövde, Bearer token başlığı. Tam yapılandırma ayrıntıları için Whapi.Cloud n8n entegrasyon rehberine bakın.
Zapier kullanıcıları aynı akışı Webhooks by Zapier tetikleyicisi ve Whapi.Cloud'un /messages/text endpoint'ine yönlendirilmiş POST eylemiyle çoğaltabilir.
Değiş tokuş gerçektir: Make ve n8n abonelik maliyeti ekler ve iş akışı işlem limitleri uygular. Günde 1.000'den fazla siparişte bu limitler, REST API yolunun tamamen önlediği sürtünme yaratır ve daha pahalıya mal olur.
Yampi Mağazalarından Gerçek Kullanım Örnekleri
Aşağıdaki örüntüler, Whapi.Cloud'u üretimde kullanan Yampi mağazalarından alınmıştır. Rakamlar mağazaların kendi verileridir.
cart.reminder ile Sepet Kurtarma
Bir Brezilya moda aksesuarları mağazası, terk etmeden 45 dakika sonra tetiklenecek şekilde cart.reminder webhook'u kurdu. Mesaj, sepet bağlantısını ve müşterinin adını içeriyor. Kurtarılan sepetlerdeki dönüşüm oranı: %18 — aynı mesajın e-posta yoluyla gönderildiği %4'e karşılık. WhatsApp mesajı okunuyor; e-posta görmezden geliniyor ya da filtreleniyor. Mağaza, Whapi.Cloud'un sabit planında mesaj başına sıfır maliyetle bu tek otomasyondan ayda yaklaşık 140 ek sipariş kazanıyor.
transaction.payment.refused ile Ödeme Başarısızlığı Kurtarma
Ödeme reddi yüksek niyet anıdır — alıcı satın almak istedi ve teknik bir aksaklık oldu. Bir Yampi elektronik mağazası, transaction.payment.refused olayında yeniden deneme bağlantısı ve sohbet yoluyla yardım teklifiyle anlık WhatsApp mesajı gönderiyor. Reddedilen ödemeli alıcıların %31'i mesajı aldıktan sonra 10 dakika içinde satın almayı tamamlıyor. Aynı mağazanın aynı olay için e-posta takibi %6'da dönüşüm sağlıyor.
São Paulo'dan Bir Moda Mağazasında Tam Yaşam Döngüsü
São Paulo'daki orta ölçekli bir moda mağazası, altı webhook olayını tek bir Whapi.Cloud kanalından yönetiyor: sipariş oluşturuldu → ödeme istemi; sipariş ödendi → tahmini gönderim süresini içeren onay; durum güncellendi (kargoya verildi) → takip bağlantısı; durum güncellendi (teslim edildi) → indirim kodu ile yorum talebi; iptal → yeniden katılım teklifi. Her mesaj, alıcının adı ve sipariş numarasıyla kişiselleştirilmiştir. Mağazanın destek talep hacmi lansmanın ardından %40 düştü — alıcılar e-posta göndermeyi bıraktı çünkü bilgiye zaten WhatsApp'tan sahipler.
Mağazalar Ne Diyor
Üç operatör (mağaza sahibi, geliştirici ve dijital ajans) entegrasyonu canlıya aldıktan sonra neyin değiştiğini anlatıyor.
«Whapi.Cloud'dan önce iki başka WhatsApp platformunu test ettik. Her ikisi de mesaj başına ücret alıyordu; bu da sipariş hacmimizde sepet kurtarma kampanyalarını kârsız kılıyordu. Whapi.Cloud'un sabit ücretiyle mesajlaşma maliyetlerinde %70'in üzerinde tasarruf ediyoruz ve 200 ms altında API yanıtları alıyoruz. Dört aydır üretimde, sıfır kesinti.»
— Rafael S., Yampi mağaza sahibi, São Paulo
«Yampi webhook'larını iki saatten kısa sürede Whapi.Cloud ile entegre ettim. Dokümantasyon açık ve HMAC imza doğrulaması kolaydı. Destek ekibimiz artık doğrudan WhatsApp üzerinden yanıt veriyor. E-posta gecikmesi yok.»
— Mariana T., E-ticaret Geliştirici
«Whapi.Cloud Partner API'sini kullanarak müşterilerimiz için 14 Yampi mağazasını yönetiyoruz. Tek entegrasyon şablonu, tüm hesaplara dağıtıldı. Müşterilerimiz aylık ödüyor, biz her şeyi merkezi olarak yönetiyoruz. White-label kurulumu bir öğleden sonra sürdü.»
— Diego F., Dijital Ajans, Rio de Janeiro
Yaklaşım Karşılaştırması: REST API vs Kodsuz vs Kapalı Platform
Doğru yol, teknik kapasiteye, sipariş hacmine ve vendor bağımlılığına toleransa bağlıdır. Sekiz kriter üzerinden dürüst karşılaştırma:
| Kriter | REST API (Whapi.Cloud) | Kodsuz (Make/n8n + Whapi) | Kapalı platform (NI/Pluga/Interakt) |
|---|---|---|---|
| Esneklik | Tam: olay başına özel mantık | Orta, görsel akışlar | Düşük, sabit şablonlar |
| Mesaj kontrolü | %100 özel içerik | %100 özel içerik | Platform şablonlarıyla kısıtlı |
| Maliyet modeli | Kanal başına aylık sabit | Make/n8n ücretleri + Whapi sabit | Mesaj başına ücret + abonelik |
| Vendor lock-in | Yok | Düşük | Yüksek |
| Kurulum süresi | ~2 saat | 30–60 dakika | Dakikalar (sonra süregelen bağımlılık) |
| Ölçeklenebilirlik | Sınırsız | Plan işlemleriyle sınırlı | Ölçeklenir ama maliyetler hızla artar |
| WhatsApp numarası | Kendi numaranız | Kendi numaranız | Çoğunlukla yeni numara gerektirir |
| Çift yönlü mesajlaşma | Evet, tam gelen mesaj desteği | Evet (webhook yapılandırmasıyla) | Plan seviyesine bağlı |
Ayda 300'den fazla siparişte, mesaj başına ücretli platformlara kıyasla maliyet farkı entegrasyonu ilk ay içinde karşılar. Günde 1.000'den fazla siparişte kodsuz yolun işlem limitleri de REST API yolunun tamamen önlediği sürtünme yaratmaya başlar.
Ajanslar İçin: Yönetilen Servis Olarak Satış
Birden fazla Yampi mağazasını yöneten bir dijital ajans işletiyorsanız, bu entegrasyon maliyetten gelire dönüşür. Whapi.Cloud'un white-label programı, Yampi WhatsApp otomasyonunu mağaza müşterilerine öngörülebilir aylık yinelenen gelirle yeniden satmanıza olanak tanır.
Pratik yapı: Whapi.Cloud Partner API'si üzerinden tüm müşteri hesaplarına dağıtılmış tek entegrasyon şablonu, her müşteri kendi kanalında (kendi WhatsApp numarasıyla), ajansınız üzerinden aylık faturalandırma. Yukarıdaki Diego F. ifadesi tam olarak bunu anlatıyor: 14 mağaza, bir şablon, bir öğleden sonra kurulum.
Ajans fiyatlandırması genellikle Whapi.Cloud kanal maliyetlerinde 3–5 kat artı kurulum ücretleri ve aylık yönetim retainer'ı olarak belirlenir. Entegrasyon tescilli bir hizmete dönüşür: ölçülebilir değer (kurtarılan sepetler, ödeme yeniden denemeleri, destek talebi azalması) her yenileme görüşmesinde haklı çıkar.
İş ortağı programı ayrıntıları: Whapi.Cloud Partner API'si, tek bir iş ortağı hesabı altında kanal oluşturma, yönetim ve izlemeye olanak tanır. Fiyatlandırma ve white-label seçenekleri için Whapi.Cloud iş ortağı programını ziyaret edin.
Uyumluluk: LGPD ve WhatsApp Opt-In
İlk mesaj gönderilmeden önce iki gereksinim sağlanmalıdır: LGPD uyumlu veri işleme onayı ve açık WhatsApp mesajlaşma opt-in'i.
LGPD (Lei Geral de Proteção de Dados): Brezilya'nın LGPD yasası kapsamında, müşteri telefon numaralarını işlemek ve otomatik mesaj göndermek için belgelenmiş bir yasal dayanak gereklidir. En yaygın dayanak, ödeme sırasında toplanan onaydır. Yampi mağazanızın hüküm ve koşulları ile gizlilik politikası, telefon numaralarının WhatsApp üzerinden sipariş güncellemeleri ve pazarlama amacıyla kullanıldığını belirtmelidir.
WhatsApp opt-in: WhatsApp'ın İşletme Politikası, alıcıların işletme numaranızdan mesaj almayı açıkça kabul etmesini gerektirir. Bunu, ödeme sırasında açıkça etiketlenmiş bir onay kutusuyla toplayın: «WhatsApp üzerinden sipariş güncellemeleri ve promosyon almayı kabul ediyorum.» Kutuyu önceden işaretlemeyin.
Abonelik iptali yönetimi: Net bir opt-out mekanizması sağlayın. En basit yaklaşım: «STOP» veya «Parar» içeren herhangi bir gelen mesajı müşterinin kaydını işaretleyerek ve gelecekteki otomatik mesajlardan çıkararak işleyin. Bu, Whapi.Cloud'un gelen mesaj webhook'unda bir seferlik bir handler'dır.
Uyumsuz mesajlaşma, LGPD cezaları ve WhatsApp numara yasakları riskini taşır. Ödeme sırasındaki onay kutusu ve webhook sunucunuzdaki STOP handler'ı birkaç saatte inşa edilebilir. Canlıya geçmeden önce bunları oluşturun.
Ücretsiz Geliştirmeye Başlayın
Whapi.Cloud'un ücretsiz sandbox'ı, üretim numarası olmadan WhatsApp test mesajları göndermenizi sağlar. Yampi webhook'larınızı bağlayın, HMAC uygulamanızı doğrulayın ve canlıya geçmeden önce uçtan uca teslimi onaylayın. Kredi kartı gerekmez.
Ücretsiz Sandbox Hesabınızı Oluşturun2 dakika sürer. Ücretsiz sandbox tam API erişimi ve geliştirici belgelerini içerir.









