Customer.io’da yüklenecek bir uygulama yoktur. Her iki yönü de standart Customer.io eylemleriyle kurarsınız, böylece hangi isteklerin çalışacağına ve hangi özniteliklerin değişeceğine tam olarak siz karar verirsiniz.
Entegrasyon nasıl çalışır
Flowella, Customer.io API’sini hiçbir zaman çağırmaz. İsteğe bağlı gelen yönde Flowella olayları yalnızca verdiğiniz webhook URL’sine gönderir ve bunlarla ne yapılacağına otomasyonunuz karar verir.
Başlamadan önce
- Bağlı bir WhatsApp numarasına sahip bir Flowella kuruluşu. Bkz. Kurulum sırası.
- Flowella’da onaylı bir WhatsApp şablonu. Bkz. Şablonlar.
- API anahtarı ve gelen senkronizasyon için webhook oluşturmak üzere Flowella’da Owner veya Admin rolü. Bkz. Ekip ve roller.
- Webhook eylemli kampanya veya otomasyon oluşturabileceğiniz bir Customer.io çalışma alanı.
- Her kişinin WhatsApp numarasının Customer.io profilinde
+447700900123gibi uluslararası biçimde kayıtlı olması. Bkz. Telefon numarası biçimi. - Her kişinin sizden WhatsApp mesajı almayı kabul etmiş olması. Meta, herhangi birine mesaj göndermeden önce izin alınmasını zorunlu tutar. Bkz. Meta’nın izin alma kılavuzu.
Customer.io’dan WhatsApp şablonu gönderme
1
Bir Flowella API anahtarı oluşturun
Flowella’da Settings ve ardından API keys bölümüne gidin ve
Customer.io production gibi bir adla canlı bir anahtar oluşturun. Anahtarı hemen kopyalayın: Flowella onu yalnızca bir kez gösterir. Bkz. API anahtarları.2
Şablon ve kanal kimliklerini bulun
Anahtarınızla
GET /v1/templates?status=APPROVED çağrısı yapın. Şablonun id ve wabaId değerlerini ve göndermek istediğiniz numaranın whatsappChannelId değerini not edin. Birden fazla numaranız varsa bkz. Çoklu kanal.3
Kampanyanıza bir webhook eylemi ekleyin
Customer.io kampanya iş akışınızda, WhatsApp mesajının gönderilmesi gereken noktaya bir Send and receive data eylemi ekleyin. Bkz. Customer.io’nun webhook eylemleri kılavuzu.
4
İsteği ayarlayın
Yöntemi
POST, URL’yi https://api.flowella.io/v1/templates/send olarak ayarlayın. Şu başlıkları ekleyin:5
İstek gövdesini yazın
Bu gövdeyi yapıştırın ve kimlikleri kendi kimliklerinizle değiştirin.
customer.phone değerini, kişinin WhatsApp numarasını tutan öznitelikle değiştirin.bodyParameters, şablonun gövde değişkenlerini sırayla doldurur: ilk değer {{1}} içine, ikincisi {{2}} içine gider ve böyle devam eder. Şablonda gövde değişkeni yoksa boş liste, [], olarak bırakın.6
Eylemi test edin
Kendi WhatsApp numaranızın olduğu bir test kişisi seçin ve Customer.io’da Test response seçeneğini seçin. Daha önce kullanmadığınız bir değerle, örneğin
test-2026-11-11-01, bir Idempotency-Key başlığı ekleyin ve her testte değiştirin. Bkz. Tekrarlanan gönderimler ve eşgüçlülük."status": "accepted" içeren bir 202 yanıtı, Flowella’nın gönderimi kuyruğa aldığı anlamına gelir. Teslimatı doğrulamaz: sonuç için Flowella’da şablonun Statistics sekmesini kontrol edin.7
Test başlığını kaldırın ve kampanyayı başlatın
Test için kullandığınız
Idempotency-Key başlığını silin veya her kişi için farklı olan bir değerle değiştirin. Ardından kampanyayı başlatın.Kişi başına ayarlayabileceğiniz şablon seçenekleri
İstek gövdesi her alıcı için şu alanları kabul eder. API’ye giriş ve OpenAPI belgesi isteğin tamamını açıklar.
Görsel, video veya belge başlığı olan bir şablon için gövdenin en üst düzeyindeki
headerMedia.url alanına herkese açık bir dosya bağlantısı ayarlayabilirsiniz.
Tekrarlanan gönderimler ve eşgüçlülük
POST /v1/templates/send aynı mesajı iki kez göndermenizi önler. Bu önemlidir, çünkü Customer.io bir webhook eylemini 2xx yanıtı almadığında yeniden dener:
Idempotency-Keybaşlığı olmadan Flowella, anahtar olarak istek gövdesinin bir karmasını kullanır. 7 gün içinde bayt bayt aynı olan bir gövde özgüniddeğerini döndürür ve hiçbir şey göndermez. Her kişinin gövdesi kendi numarasını içerdiğinden normal bir kampanya herkese bir kez gönderir.Idempotency-Keybaşlığıyla, 7 gün içinde aynı anahtara sahip her istek, gövde değişmiş olsa bile özgüniddeğerini döndürür ve hiçbir şey göndermez.- Ayrıca Flowella, aynı şablonun aynı numaraya 15 saniye içinde ikinci kez gönderilmesini atlar.
Idempotency-Key değerini her seferinde değiştirmezseniz Flowella hiçbir şey göndermez.
Büyük bir segmente gönderme
Customer.io’dan gelen her istek bir gönderimi kuyruğa alır ve Flowella bunu arka planda teslim eder, geçici WhatsApp hatalarını yeniden dener. Büyük kampanyalar için iki sınır geçerlidir:- Meta’nın mesajlaşma sınırı. Meta, kayan 24 saatlik dönemde 24 saatlik pencere dışında kaç kişiye mesaj gönderebileceğinizi sınırlar. Bkz. Mesajlaşma sınırları.
- API anahtarınızın hız sınırı. Sınırı aşan istekler,
Retry-Afterbaşlığıyla429döndürür. Bkz. Hız sınırları.
Gelen WhatsApp mesajlarını Customer.io’ya senkronize etme (isteğe bağlı)
Bu bölüm, bir kişinin size gönderdiği her WhatsApp mesajını Customer.io’ya gönderir. Böylece kişiyi güncelleyebilir veya mesajdan başka kampanyalar başlatabilirsiniz.1
Customer.io'da webhook ile tetiklenen bir otomasyon oluşturun
Webhook ile tetiklenen bir kampanya veya otomasyon oluşturun ve Customer.io’nun oluşturduğu webhook URL’sini kopyalayın. Bkz. Customer.io’nun webhook kampanyaları kılavuzu.
2
Flowella'da giden bir webhook ekleyin
Flowella’da Settings ve ardından Webhooks bölümüne gidin ve Add webhook seçeneğini seçin. Customer.io URL’sini Endpoint URL alanına yapıştırın, bir imzalama sırrı girin ve Events altında yalnızca
message.received seçeneğini işaretleyin. Bkz. Webhook’lar.3
Örnek veri gönderin
Flowella’dan kendinize bir WhatsApp şablonu gönderin ve yanıtlayın. Böylece Customer.io, iş akışını oluşturmak için gerçek bir Flowella’daki Send test event, kişi içermeyen bir
message.received olayı alır. Her olay şöyle görünür:webhook.test olayı gönderir, bu nedenle bir sonraki adımda bunu filtreleyin.4
Yalnızca gerçek gelen mesajları tutun
Yalnızca tetikleyicinin
type değeri message.received olduğunda devam eden bir True/False Branch ekleyin.5
Kişiyi Flowella'da arayın
Olay telefon numarasını değil, kimlikleri taşır.
GET yöntemi, https://api.flowella.io/v1/contacts/{{trigger.data.contactId}} URL’si ve öncekiyle aynı Authorization başlığıyla bir Send and receive data eylemi ekleyin. Yanıt, kişinin id, phone, waId, name, email, externalId, isOptedOut, createdAt ve updatedAt değerlerini içerir.Mesajın kendisini saklamak için GET /v1/messages/{{trigger.data.messageId}} adresine başka bir istek ekleyin. body alanı mesaj metnini tutar ve boş olabilir.6
Kişiyi güncelleyin
Bir Create or Update Person eylemi ekleyin. Çalışma alanınızın kişiler için kullandığı tanımlayıcıyı seçin ve yalnızca ihtiyacınız olan öznitelikleri ayarlayın, örneğin son WhatsApp yanıtının zamanı. Bkz. Customer.io’nun Create or update person kılavuzu.
Gelen webhook’un güvenliği
Flowella her isteğiX-Flowella-Signature başlığıyla imzalar. Webhook ile tetiklenen bir Customer.io otomasyonu bu imzayı kontrol edemez, bu nedenle Customer.io webhook URL’sine sahip herkes ona veri gönderebilir. URL’yi gizli tutun ve gelen senkronizasyonu izin veya faturalandırma özniteliklerini değiştirmek için kullanmayın. Olayları önce kendi uç noktanız üzerinden yönlendiriyorsanız bkz. İmzaları doğrulama.
Abonelikten çıkmalar
Bir kişiSTOP veya başka bir abonelikten çıkma anahtar kelimesi gönderdiğinde Flowella, abonelikten çıkmayı o WhatsApp numarasına kaydeder ve Customer.io’dan gelenler dahil o numaradan kişiye yapılacak sonraki tüm gönderimleri engeller. Bkz. Abonelikten çıkmalar.
Abonelikten çıkmaları Customer.io’ya kopyalamak için optout.created olayına güvenmeyin: şu anda bir kişinin bir numaradaki ilk abonelikten çıkması için tetiklenmez. Bunun yerine createdAfter ve phone filtrelerini kabul eden GET /v1/opt-outs ile abonelikten çıkmaları listeleyin.
Sorun giderme
İlgili
API'ye giriş
Kimlik doğrulama, eşgüçlülük, hız sınırları ve hatalar.
Webhook referansı
Olay türleri, istek gövdeleri ve imzalar.
Şablon değişkenleri
Değişkenler, örnekler ve yedek değerler.
Toplu gönderim
Bunun yerine Flowella uygulamasından bir listeye şablon gönderin.

