Bir HubSpot iş akışı şifre gönderemez. Flowella’nın Send WhatsApp Template eylemi, bir OTP veya kod kopyalama düğmesine her kişi için farklı bir değer veremez ve kodların HubSpot’ta tutulmaması gerekir. Bunun yerine kodları uygulamanızdan API ile gönderin.
Bir bakışta
Nasıl çalışır
Diyagram, kod talebinden girişe veya kilitlenmeye kadar tek bir giriş denemesini gösterir.Başlamadan önce
- Bir API anahtarı oluşturun. API anahtarları sayfasına bakın. Bu uç nokta OAuth erişim belirteçlerini değil, yalnızca API anahtarlarını kabul eder.
- Her müşterinin WhatsApp numarasını
+447700900123gibi uluslararası biçimde ve WhatsApp’ta kod almayı kabul ettiğini toplayın. Meta’nın onay yönergelerine bakın. - Kimlik doğrulama, hatalar ve hız sınırları için API’ye giriş sayfasını okuyun.
Şablonu oluşturun
Şablonu Meta’nın WhatsApp Manager’ında Authentication kategorisiyle ve bir kod kopyalama düğmesiyle oluşturun. Yalnızca kimlik doğrulama şablonları tek kullanımlık şifre taşıyabilir ve bunların bir kod kopyalama veya tek dokunuş düğmesine ihtiyacı vardır. Metni Meta belirler: “<code> is your verification code.” Kodu paylaşmama hatırlatması ve 1 ile 90 dakika arasında bir geçerlilik süresi satırı ekleyebilirsiniz.
URL’lere, medyaya ve emojilere izin verilmez ve kod en fazla 15 karakter olabilir. Meta şablonu onayladığında şablon Flowella’da görünür. Meta’nın şablon kategorilendirme yönergelerine ve kod kopyalama kimlik doğrulama şablonlarına bakın.
Müşterilere bir kilitlenme hakkında da mesaj gönderiyorsanız Hi {{1}}, we have paused sign-in to your account after several incorrect codes. Try again in 30 minutes or contact our support team. gibi ayrı bir Utility şablonu kullanın. Promosyon içermeyen bir hesap güvenliği uyarısı Utility kategorisine uyar.
Kod gönderin
1
Şablonu ve kanalı bulun
GET /v1/templates?status=APPROVED çağrısını yapın. Şablonunuzun id ve wabaId değerlerini ve gönderim yaptığınız numaranın whatsappChannelId değerini not edin. Birden fazla numaranız varsa Çoklu kanal sayfasına bakın.2
Kodu uygulamanızda oluşturun
En fazla 15 karakterlik rastgele bir kod üretin. Kodun bir hash değerini kısa bir geçerlilik süresiyle saklayın ve tek kullanımlık olarak işaretleyin.
3
İsteği gönderin
Kodu iki kez ekleyin: bir kez gövde parametresi olarak ve bir kez kod kopyalama düğmesinin değeri olarak. Meta’nın gönderim biçimi kod kopyalama düğmesini bir URL düğmesi olarak ele alır, bu nedenle ilk düğme için
index 0 ile subType url kullanın."status": "accepted" içeren bir 202 yanıtı, Flowella’nın gönderimi kuyruğa aldığı anlamına gelir. Teslimatı onaylamaz.4
Kodu kontrol edin
Müşteri kodu girdiğinde bunu saklanan hash değeriyle karşılaştırın. Kodu yalnızca bir kez ve yalnızca süresi dolmadan önce kabul edin.
5
Yeniden gönderimleri ve kilitlenmeyi yönetin
Her deneme için yeni bir kod gönderin ve eskisini geçersiz kılın. Yeniden göndermeden önce en az 15 saniye bekleyin: Flowella, aynı şablonun aynı numaraya 15 saniye içinde ikinci kez gönderilmesini atlar. Deneme sayısını sınırlayın, ardından girişi belirli bir süre kilitleyin ve destek sunun.
6
Sonucu HubSpot'a kaydedin (isteğe bağlı)
Uygulamanızın HubSpot kişisini HubSpot API’si aracılığıyla güncellemesini sağlayın, örneğin Last WhatsApp verification (Date and time picker) ve Last verification result (Dropdown select: Passed, Failed, Locked). Bir HubSpot iş akışı, sonuç Locked olduğunda bir görev oluşturabilir. Kodları asla HubSpot’ta saklamayın.
Entegrasyonu test edin
- Kendi WhatsApp numaranıza bir kod gönderin ve kod kopyalama düğmesinin kodu kopyaladığını kontrol edin.
- Yanlış bir kod girin, ardından bekleme süresinden sonra yeniden gönderim isteyin ve eski kodun artık çalışmadığını kontrol edin.
- Teslimatı
message.deliveredvemessage.failedwebhook olaylarıyla izleyin. Webhook’lar sayfasına bakın.
Sorun giderme
İlgili
- API’ye giriş: kimlik doğrulama, idempotency, hatalar ve hız sınırları.
- Şablon referansı: şablon kategorileri ve düğme türleri.
- Webhook’lar: Flowella’dan teslimat olaylarını alın.