Buka Master API Client.
Isi Client Code dan Nama Aplikasi.
Atur Rate Limit dan Allowed IP.
Tekan Generate API Key.
Copy key ke aplikasi eksternal.

Buka Master API Client

Client Code	Kode unik, contoh `msjhris`.
Rate Limit	Maksimal request per menit.
Allowed IPs	Whitelist IP. Kosong berarti semua IP diizinkan.
Kedaluwarsa	Opsional. Key ditolak setelah tanggal tersebut.

WHATSAPP_GATEWAY_URL={{ $public_api_base_url }}
WHATSAPP_GATEWAY_API_KEY=WA_LIVE_KEY_HASIL_GENERATE
WHATSAPP_GATEWAY_TIMEOUT=30
WHATSAPP_GATEWAY_VERIFY_SSL=true

Aturan Keamanan

Satu key per aplikasi

Jangan berbagi key antar aplikasi.

Simpan di backend

Jangan taruh key di JavaScript browser.

Whitelist IP

Gunakan bila IP server tetap.

Jangan ganti APP_KEY

Key client tersimpan terenkripsi.

`config/services.php`

'whatsapp_gateway' => [
    'url' => env('WHATSAPP_GATEWAY_URL'),
    'api_key' => env('WHATSAPP_GATEWAY_API_KEY'),
    'timeout' => (int) env('WHATSAPP_GATEWAY_TIMEOUT', 30),
    'verify_ssl' => filter_var(
        env('WHATSAPP_GATEWAY_VERIFY_SSL', true),
        FILTER_VALIDATE_BOOL
    ),
],

Contoh Pemakaian

$result = app(
    \App\Services\WhatsappGatewayService::class
)->sendText(
    'main',
    '6281234567890',
    'Tes WhatsApp Gateway'
);

WhatsappGatewayService.php

<?php

namespace App\Services;

use Illuminate\Http\Client\PendingRequest;
use Illuminate\Support\Facades\Http;

class WhatsappGatewayService
{
    private function client(): PendingRequest
    {
        $client = Http::baseUrl(
                rtrim(config('services.whatsapp_gateway.url'), '/')
            )
            ->acceptJson()
            ->asJson()
            ->withHeaders([
                'x-api-key' => config(
                    'services.whatsapp_gateway.api_key'
                ),
            ])
            ->timeout(
                config('services.whatsapp_gateway.timeout', 30)
            );

        if (! config('services.whatsapp_gateway.verify_ssl', true)) {
            $client = $client->withoutVerifying();
        }

        return $client;
    }

    public function sendText(
        string $instanceId,
        string $phone,
        string $message
    ): array {
        return $this->client()
            ->post(
                "/instances/{$instanceId}/messages",
                [
                    'to' => $phone,
                    'type' => 'text',
                    'text' => $message,
                ]
            )
            ->throw()
            ->json();
    }
}

Cari Endpoint

Method

@foreach ($endpoints as $index => $endpoint) @php $methodClass = match ($endpoint['method']) { 'GET' => 'wa-method-get', 'POST' => 'wa-method-post', 'DELETE' => 'wa-method-delete', default => '', }; $fullUrl = $public_api_base_url . $endpoint['path']; $curlId = 'waEndpointCurl' . $index; @endphp

curl -X {{ $endpoint['method'] }} \
  "{{ $fullUrl }}" \
  -H "x-api-key: WA_LIVE_KEY_HASIL_GENERATE"@if ($endpoint['payload'])
\
  -H "Content-Type: application/json" \
  -d '{!! json_encode($endpoint['payload'], JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES) !!}'
@endif

@endforeach

Endpoint tidak ditemukan.

@php $issues = [ [ 'code' => '401', 'title' => 'API key tidak valid', 'body' => 'Periksa header x-api-key dan key aplikasi yang dipakai.', ], [ 'code' => '403', 'title' => 'Akses ditolak', 'body' => 'Periksa status client, masa berlaku, dan Allowed IPs.', ], [ 'code' => '404', 'title' => 'Endpoint atau instance tidak ditemukan', 'body' => 'Periksa URL produksi dan instanceId.', ], [ 'code' => '429', 'title' => 'Rate limit tercapai', 'body' => 'Tunggu sesuai Retry-After atau naikkan Rate Limit.', ], [ 'code' => '503', 'title' => 'Gateway tidak tersedia', 'body' => 'Periksa PM2 dan log service WhatsApp Gateway.', ], ]; @endphp @foreach ($issues as $index => $issue)

{{ $issue['body'] }} @if ($issue['code'] === '503')

pm2 status
pm2 logs msj-whatsapp-gateway --lines 100

curl -i \
  -H "x-api-key: WA_LIVE_KEY_HASIL_GENERATE" \
  {{ $public_api_base_url }}/health

@endif

@endforeach

{{ $title_menu ?? 'User Manual WhatsApp Gateway' }}

{{ $step['title'] }}

Aturan Keamanan

`config/services.php`

Contoh Pemakaian

WhatsappGatewayService.php

{{ $endpoint['title'] }}