Guide v3.5

Build Faster with
WAP API CORE.

Karibu kwenye nyaraka rasmi za WAP CORE. Huu ni mfumo uliotengenezwa mahususi kurahisisha mawasiliano ya biashara nchini Tanzania Na Nchi nyingine kupitia WhatsApp. Iwe unatumia Laravel, Flutter, au Python, unaweza kuanza kutuma ujumbe ndani ya dakika mbili.

High Speed

Latency ya chini ya 200ms kwa kila ujumbe unaotumwa duniani kote.

End-to-End

Ulinzi wa AES-256 kwa data zote zinazopita kwenye gateway yetu.

Multi-Lang

SDK kamili kwa ajili ya PHP, Node.js, Python, Java, na C#.

Authentication

Kila request lazima iwe na `x-api-key` kwenye header. Unaweza kupata API Key yako kwenye dashboard yako ya WAP.

Request Header Example
GET /api/v1/instance/status
// Headers
x-api-key: "EP-K49F2S9A-XXXX-XXXX"
Content-Type: "application/json"

Security Note: Usishiriki API key yako kwenye kodi za upande wa mteja (Client-side JS). Daima tumia upande wa server (Backend) kufanya requests.

Tuma Text Message

Chagua lugha yako unayopendelea hapa chini ili kuona jinsi ya ku-integrate API yetu kwenye mradi wako.

import requests import json url = "https://wap.ephamarcysoftware.co.tz/api/v1/msg/send" payload = json.dumps({ "instance_id": "EP_INSTANCE_DEMO", "number": "255712345678", "text": "Habari! Hii ni kodi kutoka Python SDK ya WAP." }) headers = { 'x-api-key': 'YOUR_KEY_HAPA', 'Content-Type': 'application/json' } response = requests.request("POST", url, headers=headers, data=payload) print(response.text)
<?php $curl = curl_init(); curl_setopt_array($curl, [ CURLOPT_URL => "https://wap.ephamarcysoftware.co.tz/api/v1/msg/send", CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => "POST", CURLOPT_POSTFIELDS => json_encode([ "number" => "255712345678", "text" => "Habari! Hii ni kodi kutoka PHP SDK." ]), CURLOPT_HTTPHEADER => [ "x-api-key: YOUR_KEY_HAPA", "Content-Type: application/json" ], ]); $response = curl_exec($curl); curl_close($curl); echo $response;
import 'package:http/http.dart' as http; import 'dart:convert'; Future<void> sendWapMessage() async { final url = Uri.parse('https://wap.ephamarcysoftware.co.tz/api/v1/msg/send'); final response = await http.post( url, headers: { 'x-api-key': 'YOUR_KEY_HAPA', 'Content-Type': 'application/json', }, body: jsonEncode({ 'number': '255712345678', 'text': 'Habari kutoka Flutter Application!', }), ); print(response.body); }

Tuma Media (PDF/Images)

API yetu inasupport kutuma mafaili kwa kutumia Direct URL. Hakikisha faili linaishia na extension husika (.jpg, .pdf, .mp4).

JSON Payload Structure
{ "number": "255712345678", "mediatype": "image", // image, document, video, audio "url": "https://ephamarcy.co.tz/invoice_001.pdf", "caption": "Hii hapa ni risiti yako ya malipo." }

Webhooks Setup

Ili mfumo wako uweze kusoma meseji zinazoingia kutoka kwa wateja, unahitaji ku-set Webhook URL. Tutai-ping URL yako kila wakati meseji mpya inapofika.

  • Inasupport HTTPS pekee kwa usalama.
  • Response lazima iwe HTTP 200.

Configure URL

Weka URL yako kwenye dashboard chini ya 'Settings > Webhooks'

https://yourdomain.co.tz/api/whatsapp/callback

HTTP Error Codes

Code Description Solution
401 Unauthorized Check API Key
403 Instance Disconnected Scan QR Code
429 Rate Limit Exceeded Wait 60 Seconds