Melaraskan WhatsApp Business Profil & Panggilan/SIP Tetapan melalui Meta Cloud API

Sebelum anda boleh menguruskan anda WhatsApp Business profil dan panggilan/SIP tetapan, anda mesti mempunyai WhatsApp akaun berdaftar dengan Meta Cloud API.
Cara paling mudah untuk bermula ialah mendaftar dengan pembekal rasmi seperti:

  • ORENCloud — Pembekal pertama Malaysia yang menawarkan penuh WhatsApp Chat + Memanggil dalam satu platform.

  • Twilio - Global WhatsApp Business Pembekal API.

Setelah mendaftar, anda akan menerima:

  • ID Nombor Telefon — pengecam unik untuk anda WhatsApp nombor.

  • Token Akses Kekal — untuk mengesahkan panggilan API.

Simpan ini berguna, kerana kami memerlukannya untuk setiap permintaan API.


1. Dapatkan semula Profil Semasa & Panggilan/SIP Tetapan

Titik Akhir:
GET /{phone-number-id}/whatsapp_business_profile
GET /{phone-number-id}/settings?fields=calling&include_sip_credentials=true

Contoh:

# Variables
PHONE_ID="123456789012345"
TOKEN="EAAGxxxxxxxxxxxxxxxx"
GRAPH="https://graph.facebook.com/v23.0"

# Get business profile
curl -s -X GET \
  "$GRAPH/$PHONE_ID/whatsapp_business_profile?fields=about,address,description,email,websites,vertical,profile_picture_url" \
  -H "Authorization: Bearer $TOKEN" | jq

# Get calling/SIP settings (with credentials)
curl -s -X GET \
  "$GRAPH/$PHONE_ID/settings?fields=calling&include_sip_credentials=true" \
  -H "Authorization: Bearer $TOKEN" | jq

2. Kemas kini Profil Perniagaan (jika perlu)

Hantar sahaja tidak kosong padang. Anda boleh mengemas kini about, description, address, email, vertical, dan hingga laman web 2.

Contoh:

curl -s -X POST \
  "$GRAPH/$PHONE_ID/whatsapp_business_profile" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "about": "Usually replies within minutes",
    "description": "Providing premium communication services",
    "address": "123 Business St, Kuala Lumpur",
    "email": "[email protected]",
    "vertical": "OTHERS",
    "websites": ["https://example.com", "https://support.example.com"]
  }' | jq

3. Konfigurasikan Panggilan & SIP

SIP tetapan bersarang di bawah calling.sip.
Meta boleh menjana a SIP kata laluan (lihat langkah seterusnya). Sebaik sahaja anda mendayakan ini, SIP akan terus bekerja.

Contoh:

curl -s -X POST \
  "$GRAPH/$PHONE_ID/settings" \
  -H "Authorization: Bearer $TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "calling": {
      "status": "ENABLED",
      "call_icon_visibility": "DEFAULT",
      "sip": {
        "status": "ENABLED",
        "servers": [{
          "hostname": "sip.yourpbx.com",
          "port": 5061
        }]
      },
      "call_hours": {
        "status": "ENABLED",
        "timezone_id": "Asia/Kuala_Lumpur",
        "weekly_operating_hours": [
          { "day_of_week": "MONDAY", "open_time": "0900", "close_time": "1800" },
          { "day_of_week": "TUESDAY", "open_time": "0900", "close_time": "1800" }
        ]
      }
    }
  }' | jq

4. Melihat Dijana SIP Bukti kelayakan

Apabila SIP didayakan dan dikonfigurasikan, anda boleh mengambil kata laluan anda, jika anda mahu.

curl -s -X GET \
  "$GRAPH/$PHONE_ID/settings?fields=calling&include_sip_credentials=true" \
  -H "Authorization: Bearer $TOKEN" | jq

Catatan:

  • Nama pengguna: Sentiasa awak WhatsApp nombor telefon perniagaan (tanpa +)

  • kata laluan: Dipulangkan oleh Meta (simpan dengan selamat)

  • SIP Pelayan: . hostname dan port anda sediakan


5. Keselamatan & Amalan Terbaik

  • Jangan sekali-kali kongsi Token Akses anda secara terbuka — layan ia seperti kata laluan.

  • Kedai SIP kelayakan dengan selamat; berputar jika dikompromi.

  • Jika anda melumpuhkan SIP dalam tetapan, Meta akan membatalkan kelayakan.


Dengan arahan cURL ini, anda boleh mengurus anda WhatsApp Business profil dan Panggilan/SIP sepenuhnya melalui Meta Cloud API.