External Services

dazoapp bergantung pada 3 service terpisah yang tidak ada di repo ini. URL service tidak terpusat — ada dua sumber yang harus dijaga sinkron.

Sumber URL

Frontend — resources/js/global.js

Gitignored, dipilih lewat variabel env ('local' / 'development' / 'production'):

Backend — hardcoded per controller

URL tidak di config/, tapi ditulis ulang di masing-masing controller dengan pola if (env == production):

Hanya satu yang sudah dipindah ke config: config/services.php:47 (ENGINE_BOT_URL / ENGINE_BOT_TOKEN), dipakai DokuCheckoutController.php:459.

Masalah yang perlu diketahui

1. Host produksi engine WhatsApp tidak konsisten

engine.dazo.id       — 7 pemakaian
engine-wa.dazo.id    — 3 pemakaian (di AgentAiController)

Keduanya untuk service yang sama. Konfirmasi mana yang benar ke tim sebelum menulis URL baru.

2. Dua port untuk service yang sama

Tanpa keterangan mana untuk konteks apa.

3. /api/ ditambah di produksi tapi tidak di lokal

AgentAiController menambahkan /api/ di URL produksi:

$this->url_engine = 'http://localhost:5002/';           // lokal: tanpa /api/
$this->url_engine = 'https://engine-wa.dazo.id/api/';   // prod: dengan /api/

4. Pola if (env == production) diulang ~20 controller

Mengubah satu host berarti menyunting belasan file. Belum ada solusi terpusat.

Cara memanggil service

Dari frontend

import { Global } from '@/global.js'
const { url_api } = Global()

const { data } = await axiosInstance.get(`${url_api}chats/request-escalate`)

services/api.js sudah punya beberapa endpoint siap pakai:

import api from '@/services/api'
// api.chats.request_escalate
// api.chats.finish_escalate

Dari backend

Pola dominan: curl_post() / curl_get() dengan URL dari property controller:

class Downgrade extends Command
{
    public $url_engine = 'http://localhost:5002/';
    
    public function handle()
    {
        if (config('app.env') == 'production') {
            $this->url_engine = 'https://engine.dazo.id/';
        }
        
        $result = $this->curl_post($this->url_engine . 'deviceinfo', [
            'instance' => $device->id,
        ]);
    }
}

JWT ke service

JWT yang diterbitkan dazoapp dipakai sebagai kredensial saat memanggil service lain:

// Contoh: AspireController meneruskan token dari request
$token = $request->header('Authorization');
$token = str_replace('Bearer ', '', $token);
// $token dikirim ke service Aspire

Untuk Engine Bot, token ada di config:

'Authorization' => 'Bearer ' . config('services.engine_bot.token')

Detail alur JWT lihat Auth & JWT.

Service yang tidak bisa dites lokal

Integrasi pihak ketiga (bukan service internal)

Rencana pemusatan URL (belum dikerjakan)

Pusatkan semua URL service ke config/services.php untuk menghilangkan pola if (env == production) di ~20 controller. Lihat Deployment — Tahap 2 item 7 di dazoapp/README.md.

Langkah berikutnya

• Butuh auth untuk panggil service? Baca Auth & JWT.
• Baru mulai kerja? Baca Conventions.