Send WhatsApp

Send WhatsApp merupakan layanan yang dapat Anda gunakan untuk mengintegrasikan aplikasi atau sistem dengan aplikasi WhatsApp, sehingga memungkinkan pengiriman dan penerimaan pesan secara otomatis.

Sebelum Integrasi

Pastikan Anda sudah menerima kredensial dari tim Espay dan mengirimkan template pesan yang akan Anda gunakan ke tim teknis Espay.

Contoh Template Nama:

tmpl_wa_kwitansi_merchant

Contoh Template Pesan:

Terima Kasih atas Pembayaran Anda senilai Rp *[AMOUNT:20]* atas Pembelian Unit *[MODEL:100]* dengan nomor SPK sebagai berikut [NO_SPK:30].

Langkah Integrasi

Berikut ini merupakan langkah-langkah yang dapat Anda gunakan untuk integrasi dengan Espay WhatsApp Gateway:

1. Generate Hash-Based Signature

Setiap permintaan yang Anda kirim, akan divalidasi oleh Espay menggunakan parameter signature yang telah Anda buat. Pelajari pembuatan SMS & WA Gateway | Hash-Based Signature.

2. Authentication menggunakan Basic Auth

Setiap permintaan harus diverifikasi menggunakan Basic Auth. Basic Auth (Basic Authentication) merupakan metode otentikasi yang digunakan untuk memverifikasi identitas Anda sebelum diizinkan mengakses data.

Pada saat melakukan request, Anda harus mengirim header Authentication yang dengan value Basic username:password yang telah diubah menggunakan format Base64.

Contoh:
username: Aladdin
password: Jasmine

Format sebelum diencode

Username:Password
Aladdin:Jasmine

Format setelah encode Base64

QWxhZGRpbjpKYXNtaW5l

Header Authentication

Basic Base64(Username:Password)
Basic QWxhZGRpbjpKYXNtaW5l
3. Kirim WhatsApp

Flow

Anda melakukan permintaan dengan mengirimkan parameter yang dibutuhkan, dan Espay akan memberikan respons dalam bentuk JSON.

API URL

Environment URL
Sandbox
http://domain.espay/btext/send/outgoing
Production
http://domain.espay/btext/send/outgoing
Key Value
Method
HTTP Post
Connection
keep-alive
Content-Length
250
Content-Type
application/x-www-form-urlencoded
Accept
*/*
Authorization
••••••'

Parameter Permintaan

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.
sender_id
String (32)
Y
Sender id yang diberikan oleh tim Espay.
message_type
String (3)
Y
Jenis pesan.

Value:
SMS
phone_number
String (14)
Y
Nomor handphone tujuan.
temlate_id
String (64)
Y
Template whatsapp yang akan digunakan.
message
String (200)
Y
Text pesan.
broadcast
String (200)
O
Pengiriman pesan secara broadcast.

Format:
  • Ya: Y
  • Tidak: N
signature
String (64)
Y
Kode yang digunakan untuk melakukan validasi transaksi. Pelajari SMS & WA Gateway | Hash-Based Signature.
Y: Yes, O: Optional, C: Conditional

Parameter Respons

Parameter Tipe Mandatory Keterangan
rq_uuid
String (64)
Y
Request identifier. ID unik yang digunakan untuk mengidentifikasi pesan.
rs_datetime
String (19)
Y
Tanggal dan waktu transaksi yang dikirim dari server Espay.

Format:
YYYY-MM-DD HH:MM:SS

Contoh:
2014-12-17 12:30:45
error_code
String (4)
Y
Kode respons. Lihat kode respons di sini.
error_desc
String
Y
Deskripsi respons. Lihat deskripsi respons di sini.
Y: Yes, O: Optional, C: Conditional



























































































Sample Request

POST /btext/send/outgoing HTTP/1.1
Host: domain.espay
Connection: keep-alive
Content-Length: 250
Content-Type: application/x-www-form-urlencoded
Accept: */*
Authorization: ••••••

rq_uuid=fbd39734-ed32-490d-98c4-e91bcd91037a
&sender_id=21102509019CO9R
&message_type=WA
&phone_number=6285333332113
&template_id=otp_menit
&message=text:=:123456||text:=:2
&signature=3ac657060474d31095e27eb49699098c81b317ca9d34e39489c9f77ba80ab758



















Sample Positive Response

{
    "rq_uuid": "baefa025e0ca44861a9076c8Z83fccxx",
    "rs_datetime": "2018-02-27 11:57:45",
    "error_code": "0000",
    "error_message": ""
}


HTTP

POST /btext/send/outgoing HTTP/1.1
Host: domain.espay
Connection: keep-alive
Content-Length: 250
Content-Type: application/x-www-form-urlencoded
Accept: */*
Authorization: ••••••

rq_uuid=fbd39734-ed32-490d-98c4-e91bcd91037a&sender_id=21102509019CO9R&message_type=WA&phone_number=6285333332113&template_id=otp_menit&message=text%3A%3D%3A123456%7C%7Ctext%3A%3D%3A2&signature=3ac657060474d31095e27eb49699098c81b317ca9d34e39489c9f77ba80ab758


CURL

curl --location 'http://domain.espay/btext/send/outgoing' \
--header 'Host: domain.espay' \
--header 'Connection: keep-alive' \
--header 'Content-Length: 250' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--header 'Accept: */*' \
--header 'Authorization: ••••••' \

--data-urlencode 'rq_uuid=fbd39734-ed32-490d-98c4-e91bcd91037a' \
--data-urlencode 'sender_id=21102509019CO9R' \
--data-urlencode 'message_type=WA' \
--data-urlencode 'phone_number=6285333332113' \
--data-urlencode 'template_id=otp_menit' \
--data-urlencode 'message=text:=:123456||text:=:2' \
--data-urlencode 'signature=3ac657060474d31095e27eb49699098c81b317ca9d34e39489c9f77ba80ab758'
Scroll to Top