Developer Integration Guide

<?php

namespace App\Services;

use Illuminate\Support\Facades\Http;
use Illuminate\Support\Facades\Log;

class WhatsAppService
{
    protected string $baseUrl;
    protected string $apiKey;
    protected string $defaultDeviceId;

    public function __construct()
    {
        $this->baseUrl = config('services.whatsgate.url', 'https://whatsgate.deskshala.in');
        $this->apiKey = config('services.whatsgate.api_key', 'wsaas_live_YOUR_API_KEY');
        $this->defaultDeviceId = config('services.whatsgate.device_id', 'dev_corporate_alpha');
    }

    /**
     * Connect a new WhatsApp device from your CRM (returns QR Base64 & Pairing Code)
     */
    public function connectDevice(string $deviceName, ?string $webhookUrl = null): array
    {
        return Http::withToken($this->apiKey)
            ->post("{$this->baseUrl}/api/v1/devices", [
                'name'       => $deviceName,
                'webhookUrl' => $webhookUrl
            ])->json();
    }

    /**
     * Disconnect / Log out a WhatsApp device session
     */
    public function disconnectDevice(string $deviceId): array
    {
        return Http::withToken($this->apiKey)
            ->post("{$this->baseUrl}/api/v1/devices/{$deviceId}/disconnect")
            ->json();
    }

    /**
     * Send a single direct WhatsApp message via anti-ban queue
     */
    public function sendMessage(string $recipientPhone, string $text, ?string $deviceId = null): array
    {
        $response = Http::withToken($this->apiKey)
            ->timeout(15)
            ->post("{$this->baseUrl}/api/v1/messages/send", [
                'deviceId'  => $deviceId ?? $this->defaultDeviceId,
                'recipient' => preg_replace('/\D/', '', $recipientPhone),
                'message'   => $text,
                'antiBan'   => true, // Enforces 4-12s randomized human jitter
            ]);

        if ($response->failed()) {
            Log::error('WhatsApp Dispatch Failed', ['body' => $response->json()]);
            throw new \Exception($response->json('error') ?? 'Failed to send WhatsApp message');
        }

        return $response->json();
    }

    /**
     * Send parameterized template (e.g., Invoice & Payment Reminder)
     */
    public function sendInvoiceReminder(string $phone, string $customerName, string $amount, string $dueDate): array
    {
        return Http::withToken($this->apiKey)
            ->post("{$this->baseUrl}/api/v1/messages/send-template", [
                'deviceId'   => $this->defaultDeviceId,
                'recipient'  => preg_replace('/\D/', '', $phone),
                'templateId' => 'tmpl_invoice_reminder',
                'variables'  => [
                    'customerName' => $customerName,
                    'amount'       => $amount,
                    'dueDate'      => $dueDate,
                ],
                'antiBan'    => true
            ])->json();
    }
}