-
Adress Bilgisi
- Base Adress Format for Bothub Channels
- Adress Format for Azure(MsBot) Channels
- Base Adress Format for Uneeq Avatar (VH)
- How to get Base Address for Custom Integration:
- How to get Channel-Identifier for Custom Integration:
- How to get locaitonId for Custom Integration:
- How to get Share Id for Uneeq Platform:
- Tanımlı Entegrasyon Devreye Almak
Base Adress Format for Bothub Channels
{Base Address for installation / DNS}/api/v1/bot-connector/{Channel-Identifier}/webhook/{locaitonId}
Adress Format for Azure(MsBot) Channels
{Base Address for installation / DNS}/api/messages
Base Adress Format for Uneeq Avatar (VH)
{Base Address for installation / DNS}/api/v1/bot-connector/Uneeq/webhook/{locaitonId}/{Share Id}
For AWS
1. Base Address
https://bothub.eu.va.knovvu.com
2. Channel-Identifier list
whatsapp
whatsappapi
whatsapp-twilio
twitter
infobip
graphfacebook
graphwhatsapp
graphinstagram
connexease
whatsapp-unifonic
3. LocationId
347b32fd-65f1-4878-90f0-ceae7b7f2cb1
Example Endpoints :
- For AWS integration on Unifonic channel:
- For AWS integration on InfoBip channel:
- For AWS integration on Azure
https://bothub.eu.va.knovvu.com/api/messages
- For AWS integration on Uneeq
How to get Base Address for Custom Integration:
Base Address is based on installation and DNS definition, it should be given during the installation.
And it is permanent value.
How to get Channel-Identifier for Custom Integration:
This is related with implementation of a channel on code, is doesn't change by installation and valid for every instance.
Can be added new values by new implementations.
How to get locaitonId for Custom Integration:
This is generated Automatically during installation and generated by Magpie.
This value can be optained by a simple get request from BotHub services
- open swaggerpage of BotHub for the specific installation (https://{DNS definition}/swagger/index.html)
- Authorize
ClientId : BotHub
client_secret : 1q2w3e*
After Authorisation use GET LocationId method to retriew existing values, By default there must be 1 at least.
But also possible to find multiple values.
How to get Share Id for Uneeq Platform:
This is generated Automatically during Persona creation.
Tanımlı Entegrasyon Devreye Almak
Son olarak Ayarlanan "Integration" proje ayarlarından "Select Channels" Altından seçilerek kullanılmak istenen Projeye atanabilir.
Unifonic
Unifonic Portal kılavuzu :
Portal Adresi : https://cloud.unifonic.com/
1. Webhook Tanımı
Unifonic platformu altında ilgili kanal ayarları "Channels" altından bulunur ve ayarlarda Webhook bilgisi Aşağıdaki şekilde doldurulur
2. Knovvu Tanımı için gerekli verilerin toplanması
Kanal tanımını Knovvu tarafında yapabilmek için sırası ile "Developers" ve "Applications" altından ilgili
"WhatsApp" ayarı bulunur, buradan gerekli bilgiler Toparlanır.
- Service Base URL
Standart 'https://apis.unifonic.com'Link - PublicId
2. Ekran görüntüsünde year alan (ilk ekranda göz ikonuna tıklanınca açılan) "PUBLIC ID bilgisi" - Application ID
Aşağıdaki ilk ekranda "APP ID" alınmalı - Secret
2. Ekran görüntüsünde year alan (ilk ekranda göz ikonuna tıklanınca açılan) "SECRET ID bilgisi"
3. Knovvu Tanımı
Kanal tanımını Knovvu tarafında yapabilmek için sırası ile "Type" ve "Provider" bilgileri
"WhatsApp" ve "UnifonicWhatsApp" şeklinde seçilir.
istenilen bir isim (Açıklayıcı olması tavsiye edilir) tanımlanarak ilgili bilgilerin doldurulması ile devam edilir.
MsBot (Azure)
Azure Portal kılavuzu :
Portal Adresi : https://portal.azure.com/
Tüm Azure kanalları için Knovvu entegrasyonu ortak olup sadece "Type" seçimi farklılık göstermektedir.
1. Webhook Tanımı
"Configuration" kısmında "Messaging endpoint" değerine set edilir.
webhook yapısı için
2. Knovvu Tanımı için gerekli verilerin toplanması
- Application ID
ilk ekran görüntüsündeki "Microsoft App ID" değeri - Application Password
ilk ekran görüntüsündeki "Microsoft App ID" yanındaki "Manage Password" linke tıklanarak açılan 2.(Alttaki) ekran görüntüsünde yaratılan "Client secrets" kısmında yer alan ilgili Scret'ın "Value" değeri alınır.
3. Knovvu Tanımı
Kanal Özelinde bilgiler için:
Azure Bot service configuration_EceV2.docx
Facebook.docx
Slack.docx
Telegram.docx
Twilio.docx
TWILIO
Twilio Portal kılavuzu :
Portal Adresi : https://www.twilio.com/
1. Webhook Tanımı
Twilio platformu altında ilgili kanal ayarları "Messaging"->"Senders"->"WhatsApp Senders" altından ilgili telefon numarası bulunur ve açılarak ayarlarda
Webhook bilgisi Aşağıdaki şekilde doldurulur.
2. Knovvu Tanımı için gerekli verilerin toplanması
Kanal tanımını Knovvu tarafında yapabilmek için login sonrası portalda çıkan summary ekranından gerekli bilgiler Toparlanır.
- Service Base URL
Standart 'Whatsapp-Twilio' - Account Secret ID
Portalden alınn "Account SID" - Auth Token
Portalden alınn "Auth Token " - WhatsApp Target Phone Number
Portalden alınn "My Twilio phone numbe" - Status Callback Uri
Default olarak kullanmıyoruz, boş olmalı. Delivery report gibi eventler için kullanılıyor, Platformda konfigürasyonlada veriliebiliyor.
3. Knovvu Tanımı
Kanal tanımını Knovvu tarafında yapabilmek için sırası ile "Type" ve "Provider" bilgileri
"WhatsApp" ve "Twilio" şeklinde seçilir.
istenilen bir isim (Açıklayıcı olması tavsiye edilir) tanımlanarak ilgili bilgilerin doldurulması ile devam edilir.
