{"id":2613,"date":"2026-07-04T10:25:12","date_gmt":"2026-07-04T10:25:12","guid":{"rendered":"https:\/\/justfineinfotech.com\/laravel-whatsapp-two-backends-behind-one-facade-laravel-news\/"},"modified":"2026-07-04T10:25:17","modified_gmt":"2026-07-04T10:25:17","slug":"laravel-whatsapp-two-backends-behind-one-facade-laravel-news","status":"publish","type":"post","link":"https:\/\/justfineinfotech.com\/fr\/laravel-whatsapp-two-backends-behind-one-facade-laravel-news\/","title":{"rendered":"Laravel WhatsApp: Two Backends Behind One Facade – Laravel News"},"content":{"rendered":"

what<\/a>sapp” rel=”nofollow noopener” target=”_blank”>Laravel WhatsApp<\/a> is a package by Md Mostafijur Rahman<\/a> for sending and receiving WhatsApp messages from a Laravel application. What sets it apart is that it speaks to WhatsApp two different ways: through Meta’s official Cloud API for business messaging, and through an unofficial Node-based whatsapp-web.js<\/code><\/a> sidecar that uses headless Chromium to speak to the same WebSocket protocol as the WhatsApp Web app for a personal account. Both sit behind the same WhatsApp::<\/code> facade, so application code does not need to know which one is handling a given message. It supports Laravel 11, 12, and 13 on PHP 8.2 or higher.<\/p>\n

The two backends exist because they are good at different things, and the package is upfront about the trade-offs. The Cloud API is the supported path for templated business messages, but it restricts free-form replies to a 24-hour window and offers no group support. The web sidecar has no such limits and can create groups, post status updates, and pair through a QR code, but it runs against a personal account without official backing.<\/p>\n\n\n\n\n\n\n\n\n\n
Capability<\/th>\nCloud API<\/th>\nWeb Sidecar<\/th>\n<\/tr>\n<\/thead>\n
QR pairing<\/td>\nNo<\/td>\nYes<\/td>\n<\/tr>\n
Groups<\/td>\nNo<\/td>\nYes<\/td>\n<\/tr>\n
Free-form messaging<\/td>\n24h template window<\/td>\nYes<\/td>\n<\/tr>\n
Business templates<\/td>\nYes<\/td>\nNo<\/td>\n<\/tr>\n
Official support<\/td>\nYes<\/td>\nUnofficial<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n

Sending through either backend<\/h2>\n

The simplest call routes a plain text message. The recipient format decides where it goes: an E.164 phone number runs through the Cloud API, while a @c.us identifier targets the web session<\/p>\n

WhatsApp::send('+14155550123','Your Laravel News digest is ready to read.');\nWhatsApp::send('14155550123@c.us','Thanks for subscribing to the newsletter!');<\/code><\/pre>\n
For business messaging, you reach for the Cloud API’s template support directly, passing the template name, locale, and parameter components:<\/p>\n
WhatsApp::messages()->sendTemplate('+14155550123','issue_published','en_US', [\n['type'=>'body','parameters'=>[['type'=>'text','text'=>'Issue #312']]],\n]);<\/code><\/pre>\n
The web backend exposes operations that the Cloud API cannot perform. Sessions are named, so you can run more than one personal account and address each by name:<\/p>\n
WhatsApp::web('main')->groups()->create('Laracon Attendees', ['14155550123@c.us']);\nWhatsApp::web('main')->messages()->sendImage('14155550123@c.us',\n['url'=>'https:\/\/example.com\/laracon-schedule.png','caption'=>'See you at the keynote!']);<\/code><\/pre>\n
Queued sends and inbound events<\/h2>\n
Outbound messages can be dispatched as jobs through the package’s SendMessage<\/code> job, which keeps message sending off the request cycle and onto your queue workers:<\/p>\n
SendMessage::dispatch('+14155550123','New on Laravel News: this week in the ecosystem.');<\/code><\/pre>\n
Inbound messages from the sidecar are bridged into Laravel’s event system. A long-running whatsapp:web:listen<\/code> process watches the Node sidecar and fires typed events such as MessageReceived<\/code>, which you can subscribe to like any other event:<\/p>\n
useKstmostofaLaravelWhatsAppEventsWebMessageReceived;\n\u00a0\nEvent::listen(MessageReceived::class,\nfunction($event) {\nLog::info('Reader replied', ['from'=>$event->from(),'body'=>$event->body()]);\n}\n);<\/code><\/pre>\n
The Cloud API side handles inbound traffic pp secret<\/p>\n
The admin UI and persistence layer<\/h2>\n
If you install the optional Livewire and Flux dependencies, the package mounts an admin interface at \/whatsapp. It includes a dashboard, a messaging screen, conversation views rendered as chat bubbles, and pages for groups, contacts, and webhook logs. With Laravel Reverb added, the conversation views update in real time<\/p>\n
\n\"Laravel
Laravel WhatsApp Admin UI Overview<\/figcaption><\/figure>\n
\n\"Laravel
Laravel WhatsApp Admin UI Compose Message screen<\/figcaption><\/figure>\n
Persistence is opt-in through three Eloquent models: WaSession, WaMessage, and WaContact. These can live on a separate database connection if you would rather keep WhatsApp data out of your primary schema. The package also handles background event bridging, session health monitoring, and avatar and media<\/a> caching<\/p>\n
Getting started<\/h2>\n
Install the package and publish its config and migrations:<\/p>\n
composerrequirekstmostofa\/laravel-whatsapp\nphpartisanvendor:publish--tag=laravel-whatsapp-config\nphpartisanvendor:publish--tag=laravel-whatsapp-migrations\nphpartisanmigrate<\/code><\/pre>\n
The Cloud API path needs your Meta credentials in the environment:<\/p>\n
WHATSAPP_ACCESS_TOKEN=EAAG...\nWHATSAPP_PHONE_NUMBER_ID=123456789012345\nWHATSAPP_BUSINESS_ACCOUNT_ID=987654321098765\nWHATSAPP_APP_SECRET=your-meta-app-secret\nWHATSAPP_VERIFY_TOKEN=any-string-you-make-up<\/code><\/pre>\n
The web sidecar is installed and started through artisan commands, after which a listener process bridges its events back into Laravel:<\/p>\n
phpartisanwhatsapp:sidecar:install\nphpartisanwhatsapp:sidecar:start\nphpartisanwhatsapp:web:listenmain&<\/code><\/pre>\n
You can read the e commands on GitHub<\/p>\n
\"Yannick    <\/p>\n
Staff Writer at Laravel News and Full stack web developer<\/p>\n
Filed in:<\/p>\n
\n
\n    Related:<\/strong>
\n    
\n      Digital Automation Training Benin: 5 Winning Skills Employers Demand in 2026
\n    <\/a>\n  <\/p>\n
\n    
\n      WhatsApp Marketing Automation Africa: 6 Dangerous Mistakes Brands Make in Nigeria
\n    <\/a>\n  <\/p>\n<\/div>\n
\n
Want to learn this practically?<\/h3>\n
Join Justfine Infotech<\/strong> and build real digital skills<\/a> in AI, automation, web development, digital marketing, office productivity, e-commerce, freelancing and cybersecurity.<\/p>\n
Available Programmes:<\/strong>
\n  6 Weeks Certificate \u2022 3 Months Professional Certificate \u2022 6 Months Diploma \u2022 Full Professional Diploma<\/p>\n
WhatsApp:<\/strong>
\n  +229 01 57 57 99 15
\n  +229 01 66 68 11 60<\/p>\n
Enroll Now<\/a><\/p>\n<\/div>\n
Source: laravel-news.com<\/a><\/p>\n","protected":false},"excerpt":{"rendered":"
Laravel WhatsApp is a package by Md Mostafijur Rahman for sending and receiving WhatsApp messages from a Laravel application. What sets it apart is that it speaks to WhatsApp two different ways: through Meta’s official Cloud API for business messaging, and through an unofficial Node-based whatsapp-web.js sidecar that uses headless Chromium to speak to the…<\/p>","protected":false},"author":1,"featured_media":2618,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","ast-disable-related-posts":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"default","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[65],"tags":[131,132,133,130,105],"class_list":["post-2613","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-whatsapp-business-sme-growth","tag-backends","tag-behind","tag-facade","tag-laravel","tag-whatsapp"],"_links":{"self":[{"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/posts\/2613","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/comments?post=2613"}],"version-history":[{"count":1,"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/posts\/2613\/revisions"}],"predecessor-version":[{"id":2617,"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/posts\/2613\/revisions\/2617"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/media\/2618"}],"wp:attachment":[{"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/media?parent=2613"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/categories?post=2613"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/justfineinfotech.com\/fr\/wp-json\/wp\/v2\/tags?post=2613"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}