Looking to hire Laravel developers? Try LaraJobs
This package is not available.

fernway-laravel maintained by jeromebadour

Description
Send your Laravel app's leads into GoHighLevel through Fernway, with retries, and hear back through its signed webhooks.
Author
Last update
2026/11/14 14:28 (dev-main)
License
Downloads
1

Comments
comments powered by Disqus

Fernway for Laravel

Send your Laravel app's leads into GoHighLevel through Fernway, with retries that never send a lead twice, and hear back through Fernway's signed webhooks as ordinary Laravel events.

Laravel 12 and 13, PHP 8.2 or later.

Install

composer require jeromebadour/fernway-laravel
FERNWAY_KEY=fw_...              # Fernway console, API keys (shown once)
FERNWAY_ROUTE=callback          # the route a lead takes when it names none
FERNWAY_WEBHOOK_SECRET=whsec_...  # Fernway console, Webhooks (shown once); leave out to receive none
php artisan fernway:test roof-check   # the key, a booking route's free times, the webhook address

Send a lead

use Fernway\Laravel\Facades\Fernway;
use Fernway\Laravel\Lead;

$lead = Lead::to('roof-check')
    ->key("order-{$order->id}")            // your own id: sending it again never makes a second lead
    ->name('Dana', 'Whitfield')
    ->email('dana@example.com')
    ->phone('+1 253 555 0142')
    ->address('14 Cedar Ln', 'Tacoma', 'WA', '98406', 'US')
    ->message('Old roof, a leak by the chimney')
    ->at($slot);                           // booking routes: a time from Fernway::slots('roof-check')

Fernway::send($lead);       // queued; LeadSent or LeadRefused follows
$sent = Fernway::sendNow($lead);   // or now: $sent->number ("FW 26 00817"), $sent->receipt

Queued sends retry when Fernway is busy or can't be reached (10 s, 30 s, 2 min, 10 min, 30 min, 1 h; a 429 waits as long as Fernway asks), always with the lead's own key, so a try whose answer was lost is never a second lead. A lead Fernway refuses is never retried: LeadRefused carries Fernway's reasons, the field first. Out of tries, or a refused key: LeadNotSent.

Hear back

Add an endpoint in Fernway's console (Webhooks) pointing at https://your-app/fernway/webhook and set its secret. Each delivery is checked (HMAC-SHA256 of the raw body, constant-time compare, five minutes either side) before it becomes an event; a forged or replayed call gets a 400, and a retry of the same delivery fires once.

use Fernway\Laravel\Events\LeadHeld;
use Fernway\Laravel\Events\LeadSignedFor;

Event::listen(fn (LeadSignedFor $e) => Order::where('waybill', $e->waybill())->update(['in_crm' => true]));
Event::listen(fn (LeadHeld $e) => Log::warning("GHL held {$e->waybill()}: {$e->reason()}"));
Fernway event Laravel event
lead.picked_up LeadPickedUp
lead.signed LeadSignedFor
lead.held LeadHeld (reason(), in GHL's words)
lead.returned LeadReturned
lead.scored LeadScored (score(), 1 to 5)
fernway.test WebhookTest

Tests

Its own tests run on Laravel 12 (PHP 8.2) and 13 (PHP 8.4). Fernway's CI also installs it into a fresh Laravel app that sends real leads through Fernway into a stand-in GoHighLevel and receives Fernway's signed webhooks.

Built by Jerome Badour. All rights reserved.

License

MIT. See LICENSE.