API Messenger & Integrasi Webhook untuk Bot (Tutorial 2026)

Published

February 15, 2026

Read time

10 menit baca

Ditulis oleh

Morgan Huber

Mengotomatisasi notifikasi melalui bot messenger memperlancar alur kerja pengembangan, memungkinkan peringatan instan ketika build selesai, error terjadi, atau deployment selesai. Panduan ini memberikan instruksi langkah demi langkah untuk menanamkan bot yang dapat mengirim pesan otomatis melalui webhook di berbagai platform perpesanan populer. Baik Anda perlu memberi tahu tim Anda tentang hasil pipeline CI/CD, peringatan pemantauan server, atau penyelesaian proses otomatis apa pun, integrasi ini menjadikannya mungkin. Kami hanya membahas platform dengan kemampuan integrasi bot yang mudah - beberapa messenger yang aman mengutamakan privasi daripada fitur otomatisasi dan sengaja dikecualikan.

Daftar Isi

Memahami Otomatisasi Bot Berbasis Webhook
Panduan Integrasi Bot Messenger
Bot Webhook Discord
Bot Webhook Slack
Bot Webhook Microsoft Teams
Bot Telegram
Bot Webhook Mattermost
Bot Matrix/Element
Bot WhatsApp Business
Bot Facebook Messenger
Messenger Tanpa Dukungan Bot yang Mudah
Contoh Implementasi Praktis
Kesimpulan
Pertanyaan yang Sering Diajukan

Memahami Otomatisasi Bot Berbasis Webhook

Bot berbasis webhook beroperasi dengan prinsip sederhana: aplikasi Anda mengirimkan permintaan HTTP POST ke URL tertentu, dan platform perpesanan mengirimkan konten tersebut ke saluran atau pengguna. Arsitektur ini ideal untuk skenario otomatisasi seperti:

Notifikasi build - Peringatkan ketika kompilasi berhasil atau gagal dengan detail error
Update deployment - Beri tahu tim ketika kode mencapai staging atau produksi
Peringatan pemantauan - Kirim peringatan kesehatan server atau notifikasi downtime
Laporan terjadwal - Sampaikan metrik harian atau ringkasan status

Alur kerja intinya melibatkan:

Membuat bot atau URL webhook di platform target
Mengkonfigurasi alat otomatisasi Anda (CI/CD, sistem pemantauan, skrip kustom) untuk mengirim permintaan HTTP
Memformat muatan pesan sesuai dengan spesifikasi platform

Memahami bagaimana platform messenger yang berbeda menangani keamanan dan enkripsi sangat penting untuk memilih platform yang tepat untuk notifikasi Anda. Untuk penjelasan lebih mendalam tentang pertimbangan keamanan khusus platform, lihat Panduan Utama tentang Messenger di 2026.

Panduan Integrasi Bot Messenger

Berikut adalah panduan langkah demi langkah untuk setiap platform yang mendukung integrasi bot berbasis webhook yang mudah untuk mengirim pesan otomatis.

Bot Webhook Discord

How to setup different webhook bots in 2026 simple and easy

Discord menawarkan implementasi webhook paling sederhana, tidak memerlukan aplikasi bot atau token otentikasi untuk pengiriman pesan dasar.

Pengaturan Langkah demi Langkah

Buka Pengaturan Server - Klik kanan pada nama server Anda dan pilih "Server Settings"
Navigasi ke Integrasi - Klik "Integrations" di sidebar kiri
Buat Webhook - Klik "Webhooks" kemudian "New Webhook"
Konfigurasi Webhook - Beri nama webhook Anda (misalnya, "Build Bot"), pilih saluran target, dan secara opsional unggah avatar
Salin URL Webhook - Klik "Copy Webhook URL" dan simpan dengan aman

Mengirim Pesan melalui Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"content": "✅ Build berhasil diselesaikan!\n\nProject: MyApp\nBranch: main\nDuration: 3m 42s"}' \
  https://discord.com/api/webhooks/YOUR_WEBHOOK_ID/YOUR_WEBHOOK_TOKEN

Contoh Embed Kaya untuk Notifikasi Error

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "embeds": [{
      "title": "❌ Build Gagal",
      "color": 15158332,
      "fields": [
        {"name": "Project", "value": "MyApp", "inline": true},
        {"name": "Branch", "value": "feature/login", "inline": true},
        {"name": "Error", "value": "```TypeError: Cannot read property of undefined```"}
      ],
      "timestamp": "2026-01-15T10:30:00.000Z"
    }]
  }' \
  YOUR_WEBHOOK_URL

Dokumentasi Resmi: Dokumentasi Webhook Discord

Bot Webhook Slack

Slack menyediakan Incoming Webhooks sebagai bagian dari sistem Slack Apps, menawarkan format pesan yang kaya dan fleksibilitas saluran.

Pengaturan Langkah demi Langkah

Buat Slack App - Kunjungi api.slack.com/apps dan klik "Create New App"
Pilih Metode Pembuatan - Pilih "From scratch" dan beri nama app Anda (misalnya, "CI/CD Notifications")
Aktifkan Incoming Webhooks - Navigasi ke "Incoming Webhooks" di sidebar kiri dan aktifkan
Tambahkan Webhook ke Workspace - Klik "Add New Webhook to Workspace"
Pilih Saluran - Pilih saluran di mana notifikasi harus muncul dan klik "Allow"
Salin URL Webhook - URL webhook unik Anda sekarang ditampilkan

Mengirim Pesan melalui Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Deployment ke produksi berhasil diselesaikan!"}' \
  https://hooks.slack.com/services/T00000000/B00000000/XXXXXXXXXXXXXXXX

Pesan Block Kit untuk Notifikasi Terperinci

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "blocks": [
      {
        "type": "header",
        "text": {"type": "plain_text", "text": "🚨 Build Gagal"}
      },
      {
        "type": "section",
        "fields": [
          {"type": "mrkdwn", "text": "*Project:*\nMyApp"},
          {"type": "mrkdwn", "text": "*Branch:*\nmain"},
          {"type": "mrkdwn", "text": "*Error:*\n`Module not found`"}
        ]
      }
    ]
  }' \
  YOUR_WEBHOOK_URL

Dokumentasi Resmi: Panduan Incoming Webhooks Slack

Bot Webhook Microsoft Teams

Microsoft Teams mendukung Incoming Webhooks untuk notifikasi saluran, diintegrasikan melalui sistem konektor.

Pengaturan Langkah demi Langkah

Buka Pengaturan Saluran - Navigasi ke saluran target, klik tiga titik (•••) di samping nama saluran
Pilih Konektor - Klik "Connectors" (atau "Manage channel" lalu "Connectors" di versi yang lebih baru)
Temukan Incoming Webhook - Cari "Incoming Webhook" dan klik "Configure"
Beri Nama Webhook Anda - Berikan nama (misalnya, "Build Alerts") dan secara opsional unggah gambar
Buat dan Salin URL - Klik "Create" dan salin URL webhook yang disediakan

Mengirim Pesan melalui Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build #1234 berhasil diselesaikan di branch main"}' \
  YOUR_TEAMS_WEBHOOK_URL

Adaptive Card untuk Notifikasi Kaya

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "type": "message",
    "attachments": [{
      "contentType": "application/vnd.microsoft.card.adaptive",
      "content": {
        "type": "AdaptiveCard",
        "version": "1.2",
        "body": [
          {"type": "TextBlock", "size": "Large", "weight": "Bolder", "text": "❌ Build Gagal"},
          {"type": "FactSet", "facts": [
            {"title": "Project:", "value": "MyApp"},
            {"title": "Error:", "value": "Compilation failed"}
          ]}
        ]
      }
    }]
  }' \
  YOUR_TEAMS_WEBHOOK_URL

Dokumentasi Resmi: Incoming Webhooks Microsoft Teams

Bot Telegram

Telegram menawarkan Bot API yang kuat yang memungkinkan pengiriman pesan secara terprogram. Tidak seperti webhook, Anda mengirim permintaan langsung ke API Telegram.

Pengaturan Langkah demi Langkah

Buat Bot melalui BotFather - Buka Telegram dan cari @BotFather
Mulai Bot Baru - Kirim perintah /newbot
Beri Nama Bot Anda - Ikuti petunjuk untuk mengatur nama tampilan dan nama pengguna (harus diakhiri dengan "bot")
Simpan Token API - BotFather memberikan token API seperti 123456789:ABCdefGHIjklMNOpqrsTUVwxyz
Dapatkan Chat ID - Tambahkan bot ke grup/saluran Anda, kirim pesan, lalu kunjungi https://api.telegram.org/bot<TOKEN>/getUpdates untuk menemukan chat ID

Mengirim Pesan melalui Bot API

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -d "chat_id=" \
  -d "text=✅ Build berhasil diselesaikan!%0A%0AProject: MyApp%0ABranch: main" \
  -d "parse_mode=HTML"

Pesan Terformat dengan HTML

curl -X POST \
  "https://api.telegram.org/bot/sendMessage" \
  -H "Content-Type: application/json" \
  -d '{
    "chat_id": "",
    "text": "❌ Build Gagal\n\nProject: MyApp\nBranch: main\nError: Module not found",
    "parse_mode": "HTML"
  }'

Dokumentasi Resmi: Telegram Bot API

Bot Webhook Mattermost

Mattermost adalah alternatif Slack open-source dengan dukungan webhook yang sangat baik, ideal untuk komunikasi tim yang di-host sendiri.

Pengaturan Langkah demi Langkah

Akses Integrasi - Klik menu hamburger, lalu "Integrations"
Buat Incoming Webhook - Pilih "Incoming Webhooks" lalu "Add Incoming Webhook"
Konfigurasi Webhook - Tetapkan judul, deskripsi, dan pilih saluran default
Simpan dan Salin URL - Klik "Save" dan salin URL webhook

Mengirim Pesan melalui Webhook

curl -X POST -H "Content-Type: application/json" \
  -d '{"text": "✅ Build berhasil diselesaikan!"}' \
  https://your-mattermost-server.com/hooks/YOUR_WEBHOOK_ID

Pesan Lampiran Kaya

curl -X POST -H "Content-Type: application/json" \
  -d '{
    "attachments": [{
      "fallback": "Build Failed",
      "color": "#FF0000",
      "title": "❌ Build Gagal",
      "fields": [
        {"short": true, "title": "Project", "value": "MyApp"},
        {"short": true, "title": "Branch", "value": "main"},
        {"short": false, "title": "Error", "value": "```Module not found```"}
      ]
    }]
  }' \
  YOUR_WEBHOOK_URL

Dokumentasi Resmi: Mattermost Incoming Webhooks

Bot Matrix/Element

Matrix adalah protokol terbuka untuk komunikasi terdesentralisasi, dengan Element menjadi klien paling populer. Integrasi bot memerlukan penggunaan Matrix Client-Server API.

Pengaturan Langkah demi Langkah

Buat Akun Bot - Daftarkan akun Matrix baru untuk bot Anda di homeserver Anda atau matrix.org
Dapatkan Token Akses - Login dan ambil token akses dari Element: Settings → Help & About → Advanced → Access Token
Dapatkan Room ID - Bergabunglah dengan ruangan target dengan bot Anda, lalu temukan room ID di Room Settings → Advanced
Undang Bot ke Ruangan - Pastikan akun bot telah bergabung dengan ruangan tempat Anda ingin mengirim pesan

Mengirim Pesan melalui Matrix API

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"msgtype": "m.text", "body": "✅ Build berhasil diselesaikan!"}' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

Pesan Terformat dengan HTML

curl -X PUT \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "msgtype": "m.text",
    "body": "Build Gagal\nProject: MyApp\nError: Module not found",
    "format": "org.matrix.custom.html",
    "formatted_body": "❌ Build Gagal
Project: MyApp
Error: Module not found"
  }' \
  "https://matrix.org/_matrix/client/r0/rooms/YOUR_ROOM_ID/send/m.room.message/$(date +%s)"

Tip: Untuk pengembangan bot Matrix yang lebih mudah, pertimbangkan untuk menggunakan pustaka seperti matrix-nio (Python) atau matrix-bot-sdk (JavaScript).

Dokumentasi Resmi: Spesifikasi Matrix Client-Server API

Bot WhatsApp Business

WhatsApp menawarkan Business API untuk pengiriman pesan otomatis, meskipun memerlukan verifikasi bisnis dan memiliki pengaturan yang lebih kompleks daripada platform lain.

Pengaturan Langkah demi Langkah

Buat Akun Meta Business - Kunjungi business.facebook.com dan buat akun bisnis
Siapkan WhatsApp Business - Navigasi ke developers.facebook.com, buat aplikasi, dan tambahkan produk WhatsApp
Konfigurasi Nomor Telepon - Tambahkan nomor telepon untuk bot Anda (nomor tes tersedia untuk pengembangan)
Dapatkan Token Akses - Hasilkan token akses permanen dari dashboard aplikasi
Verifikasi Bisnis - Selesaikan verifikasi bisnis untuk penggunaan produksi

Mengirim Pesan melalui Cloud API

curl -X POST \
  "https://graph.facebook.com/v17.0/YOUR_PHONE_NUMBER_ID/messages" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "messaging_product": "whatsapp",
    "to": "RECIPIENT_PHONE_NUMBER",
    "type": "text",
    "text": {"body": "✅ Build berhasil diselesaikan!"}
  }'

Penting: WhatsApp memerlukan template pesan untuk memulai percakapan dengan pengguna. Anda hanya dapat mengirim pesan bentuk bebas dalam waktu 24 jam setelah interaksi pengguna. Untuk notifikasi otomatis, buat dan setujui template pesan terlebih dahulu.

Dokumentasi Resmi: Dokumentasi WhatsApp Cloud API

Bot Facebook Messenger

Facebook Messenger bot memerlukan Facebook App dan Page, dengan pesan yang dikirim melalui Send API.

Pengaturan Langkah demi Langkah

Buat Facebook App - Kunjungi developers.facebook.com dan buat aplikasi baru (pilih tipe "Business")
Tambahkan Produk Messenger - Di dashboard aplikasi Anda, klik "Add Product" dan pilih Messenger
Hubungkan Facebook Page - Tautkan Facebook Page ke aplikasi Anda (buat jika diperlukan)
Hasilkan Token Akses Page - Di pengaturan Messenger, hasilkan token untuk halaman Anda
Dapatkan PSID - Pengguna harus mengirim pesan ke halaman Anda terlebih dahulu; tangkap Page-Scoped ID (PSID) mereka dari peristiwa webhook

Mengirim Pesan melalui Send API

curl -X POST \
  "https://graph.facebook.com/v17.0/me/messages" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {"id": "USER_PSID"},
    "message": {"text": "✅ Build berhasil diselesaikan!"},
    "access_token": "YOUR_PAGE_ACCESS_TOKEN"
  }'

Catatan: Facebook Messenger memiliki kebijakan ketat tentang pesan otomatis. Bot hanya dapat mengirim pesan promosi dalam waktu 24 jam setelah interaksi pengguna. Untuk notifikasi di luar jendela ini, Anda perlu mengajukan permohonan untuk tag pesan tertentu atau menggunakan fitur notifikasi satu kali.

Dokumentasi Resmi: Dokumentasi Platform Facebook Messenger

Messenger Tanpa Dukungan Bot yang Mudah

Messenger berikut mengutamakan privasi dan keamanan daripada fitur otomatisasi, membuat integrasi bot berbasis webhook menjadi tidak mungkin atau tidak praktis:

Signal - Tidak ada API bot resmi. Signal mengutamakan enkripsi end-to-end dan privasi pengguna, sengaja menghindari fitur otomatisasi yang dapat membahayakan keamanan.
Session - Messenger terdesentralisasi tanpa infrastruktur bot. Arsitektur perutean bawang membuat pengiriman pesan otomatis tidak praktis.
Briar - Messenger peer-to-peer yang dirancang untuk aktivis dan jurnalis. Tidak ada infrastruktur server berarti tidak ada kemampuan webhook.
Wire - Meskipun Wire memiliki beberapa fitur API perusahaan, tidak ada sistem webhook sederhana untuk notifikasi otomatis.
Wickr - Berfokus pada perusahaan tanpa API bot publik. Otomatisasi memerlukan Wickr Enterprise dengan integrasi kustom.
SimpleX - Desain yang mengutamakan privasi tanpa pengenal pengguna membuat integrasi bot tidak kompatibel secara arsitektur.
Threema - Menawarkan Threema Gateway untuk bisnis, tetapi ini adalah layanan berbayar yang memerlukan kontrak, bukan pengaturan webhook sederhana.
Viber - Memiliki API bot tetapi memerlukan persetujuan akun bisnis dan terutama dirancang untuk layanan pelanggan, bukan notifikasi pengembang.
LINE - Menawarkan Messaging API tetapi memerlukan verifikasi akun bisnis dan kompleks untuk kasus penggunaan notifikasi sederhana.
WeChat - API Akun Resmi ada tetapi memerlukan pendaftaran bisnis Tiongkok dan persetujuan pemerintah.

Untuk kebutuhan komunikasi aman di mana platform ini lebih disukai, pertimbangkan untuk menggunakannya bersama platform yang didukung untuk otomatisasi, atau jelajahi panduan kami tentang menjaga pesan pribadi tetap benar-benar aman.

Contoh Implementasi Praktis

Berikut adalah contoh Node.js lengkap yang mengirimkan notifikasi build ke beberapa platform secara bersamaan:

const axios = require('axios');

const notifiers = {
  discord: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { content: message });
  },

  slack: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  },

  telegram: async (message, token, chatId) => {
    await axios.post(`https://api.telegram.org/bot${token}/sendMessage`, {
      chat_id: chatId,
      text: message,
      parse_mode: 'HTML'
    });
  },

  teams: async (message, webhookUrl) => {
    await axios.post(webhookUrl, { text: message });
  }
};

async function notifyBuildResult(success, project, branch, error = null) {
  const emoji = success ? '✅' : '❌';
  const status = success ? 'succeeded' : 'failed';
  let message = `${emoji} Build ${status}\n\nProject: ${project}\nBranch: ${branch}`;
  if (error) message += `\nError: ${error}`;

  const notifications = [
    notifiers.discord(message, process.env.DISCORD_WEBHOOK),
    notifiers.slack(message, process.env.