whatsapp-laravel-sdk

Whatsapp Laravel SDK

This Laravel package’s goal is to abstract and simplify the integration with the Facebook’s Whatsapp Business API through services, facades and methods, as well properly documenting how to work with it, since it is sometimes hard to find the info you need to correctly implement the API.

Check our package on Packagist.

Project Standards

[WIP]

Project Meta Data

All Contributors

Project Status

[WIP]

Table of Contents

Composer Scripts

We tried to automate as much boring tasks and CLI commands as we could on short composer scripts. Below you will find a general description of what each one does:

Run and Test

We included a sample fresh Laravel app to help those who want to contribute to the package. To start it just go through the following steps:

  1. Clone this repository and cd into the sample app folder (<repository-folder>/samples/laravel-11).
  2. Run composer setup from the repository root. It will cd on sample app’s folder, install the dependencies and cd back to the root folder.
  3. Run composer start from the repository root. It will run the sample app through artisan serve command.
  4. With the local server running, from another terminal run composer serve from the repository. It will connect to serveo service and expose your local application to the web.

Configure Whatsapp Webhook

[WIP]

Tooling

There are a few tools we provide alongside with the source code to ease a little bit the burden of following a bunch of patterns and standards we set up, as well as automate some boring processes.

Comitizen

This CLI helps with writting commit messages in a meaningful and standardized way, so that our automation process can use them to properly write our software changelog.

If you like the tool, kudo the devs ;)

How to use Comitzen

Just run composer commit from the repository’s root folder instead of the traditional git commit and follow the CLI interactive steps :)

Sample App

For those who want to test and/or contribute to this package, we included a sample fresh laravel application with the package already locally loaded, so you can emulate a real Laravel application that uses the package :)

How to run the Sample App

Just run composer serve from the repository’s root folder. The script will cd into the sample folder and run the Laravel artisan command php artisan serve from there.

Serveo

This service allows routing external requests to your local environment. You can use it to test your Watsapp webooks locally while developing.

If you like the tool, kudo the devs ;)

How to use Serveo

Just run composer connect from the repository’s root folder. You will need to have our sample application running so you can receive webhook requests locally.

Contributors

Kudos to all our dear contributors. Without them, nothing would have been possible :heart:

Rafael Eduardo Paulin
Rafael Eduardo Paulin
💻 🎨 📖 🤔 🚇 🚧 📆 👀 ⚠️ 🔧 ✅

Would you like to see your profile here? Take a look on our Code of Conduct and our Contributing docs, and start coding! We would be thrilled to review a PR of yours! :100:

back to top

Changelog

All changes made to this package since the start of development can be found either on our release list or on the changelog.

back to top

Roadmap

Any planned enhancement to the package will be described and tracked in our project page

back to top

This site is open source. Improve this page.