Kurumsal WhatsApp Mesajlaşma

Whatsapp Api Hakkında

Wamessage WhatsApp API (unofficial), kullanıcıların WhatsApp üzerinden çeşitli işlemleri gerçekleştirmelerini sağlayan kapsamlı bir araçtır. Bu API, işletmelerin ve geliştiricilerin WhatsApp entegrasyonlarını kolaylaştırarak, müşteri iletişimini ve operasyonel verimliliği artırmalarına olanak tanır. Wamessage API ile JSON formatında iletişim kurarak, uygulamalarınıza kolayca entegre edebilirsiniz. Aşağıdaki dökümanda Postman ile bunun nasıl yapıldığı anlatılmıştır.

API, kullanıcılara aşağıdaki başlıca özellikleri sunar:

  1. Mesaj Gönderme: WhatsApp üzerinden bireysel veya toplu mesaj gönderimi yapabilirsiniz.
  2. Giriş ve Doğrulama: Telefon numaraları veya QR kodları ile giriş yapmalarını sağlar.
  3. Profil Bilgileri: Kullanıcıların WhatsApp profil resimlerini ve diğer bilgilerini alabilirsiniz.
  4. Cihaz Yönetimi: Kullanıcıların bağlı oldukları cihazları yönetme ve listeleme imkanını sunar.

Bu dokümantasyon, API'nin nasıl kullanılacağını ve her bir uç noktanın işlevselliğini detaylandırmaktadır. Tüm API istekleri, güvenli bir şekilde kimlik doğrulama bilgileri ile yapılmalıdır. Göndermeniz gereken isteğin body formatı JSON veya Form-Data olabilir. İsteğinizi gönderirken uygun formatta olmasına dikkat edin.

Wamessage Api Ne Amaçla Kullanılır?

Kişilere bu api aracılığıyla whatsapp üzerinden mesaj gönderebilirsiniz.

Api Kullanımında Dikkat Edilmesi Gerekenler

Kayıt ol ve giriş yap isteği dışındaki isteklerin Headers kısmına Bearer Token girilmeli. Bunu yapmak için ilk önce hesabımız yoksa kayıt olmalıyız, daha sonrasında ise giriş yaparak gelen cevaptaki token değerini alarak Headers kısmında key değerini “Authorization” ve value değerini “Bearer token” olarak girmeliyiz buradaki token ifadesi giriş isteğinden aldığımız token değeridir.

Postman İle Dökümanın Açılması

Postman açıldıktan sonra yukarıdaki görselde sağ üst kısımda bulunan import butonuna tıkladıktan sonra file seçeneği ile wamessage-doc isimli dokümanı ekleyebilirsiniz.

Wamessage-doc Postman Dosyasını İndirin.

Giriş (Login)

  1. Bu API, kullanıcıların uygulamaya giriş yapmasını sağlar. Giriş başarılı olduğunda, bir token alırsınız, bu token'i sonraki isteklerde kullanmanız gerekir.
  2. POST https://api.wamessage.app/user/login
  3. Parametreler
    1. phone: Kullanıcının kayıt olduğu telefon numarası.
    2. password: Kullanıcının kayıt olduğu şifre.
  4. Headers
    1. Authorization: Bearer [TOKEN]
  5. Body Formatı
    1. json

İstek sonucu dönen cevapta token değerini alarak bundan sonraki işlemlerde headers kısmına Authorization keyinin value değeri olarak eklenmelidir.

İsteğe Token Ekleme

Cihaz Bağlama (Connecting Whatsapp Device)

  1. Bu API, kullanıcıların WhatsApp hesaplarına bağlanmalarını sağlar. WhatsApp'a bağlanmak için bir doğrulama kodu gereklidir.
  2. POST https://api.wamessage.app/whatsapp/login/code
  3. Parametreler
    1. phone: WhatsApp'a bağlanmak istenilen telefon numarası.
  4. Headers
    1. Authorization: Bearer [TOKEN]
  5. Body Formatı
    1. json

Bu istek sonucu gelen cevapta whatsapp oturumu açmak için bir kod(code) geliyor bunu kullanarak whatsapp bağlı cihazlar üzerinden cihaz bağlaya ardından telefon numarası kullanarak bağlan ile cihazı bağlayabilirsiniz.

Bu istek sonucu gelen cevapta bir diğer parametre olarak bulunan registrationId değerini alarak bir sonraki istekte kullanmalısınız.

Bağlı Cihazı Kontrol (Check Connected Device)

  1. Bu API, bir önceki istekte alınan registrationId değeri ile oturum açılan cihazın bağlı olup olmadığını test etmek ve bağlı ise cihazı sisteme kaydetmek için kullanılır.
  2. GET https://api.wamessage.app/whatsapp/ws/logincontrol?registrationId=1111111&phone=905555555555
  3. Headers
    1. Authorization: Bearer [TOKEN]
  4. Parametreler
    1. registrationId: bir önceki adımda üretilen registrationId değerini alarak buraya girmemiz gerekiyor
    2. phone: whatsapp a bağlanan telefon numarasını başında + olmadan buraya ekliyoruz

Bağlı Cihazları Listele (List Connected Devices)

  1. Bu API, bağlı cihazları listelemek için kullanılır.
  2. GET https://api.wamessage.app/whatsapp/devices?page=-1
  3. Headers
    1. Authorization: Bearer [TOKEN]

Mesaj Gönder (Send Message)

  1. Bu API, kullanıcıların belirtilen kişilere WhatsApp mesajı göndermelerini sağlar.
  2. POST https://api.wamessage.app/whatsapp/sendmessage/multi
  3. Headers
    1. Authorization: Bearer [TOKEN]
  4. Body Formatı
    1. form-data
  5. Parametreler
    1. reg_id: Gönderimlerin yapılacağı cihazların kayıt ID'si. Cihazları listeleyen istek istek ile alınan registration_id değerini kullanın.
    2. contacts: Mesajın gönderileceği kişilerin telefon numaraları. Numaraları virgülle ayrılmış şekilde girin.
    3. message: Kullanıcılara gönderilecek mesaj içeriği.
    4. file: Eğer bir dosya gönderilecekse, dosya yüklemek için bu parametre kullanılmalıdır.
    5. send_time: İleri tarihli gönderimler için kullanılır. Şimdi gönderimler için bu parametre boş bırakılmalıdır. İleri bir tarih belirlemek için "YYYY-MM-DD HH:MM:SS" formatında zaman bilgisi girilmelidir.

Whatsapp bağlantısını kes (whatsapp logout)

  1. Bu API, belirtilen WhatsApp numarasına bağlı oturumu sonlandırmak için kullanılır.
  2. POST https://api.wamessage.app/whatsapp/logout
  3. Parametreler
    1. reg_id: Oturumu kapatılacak WhatsApp hesabının registrationId'si.
    2. phone: Oturumu kapatılacak WhatsApp hesabının telefon numarası.
  4. Headers
    1. Authorization: Bearer [TOKEN]
  5. Body Formatı
    1. json