Overview
Icon for Whatsapp

Whatsapp

Enable WhatsApp messaging and alerts for your store

Medusa-Plugin-Whatsapp

Bring two poplar platforms together

Getting started

Installation

yarn add medusa-plugin-whatsapp

Usage

Api

Configure the sandbox webhook to point to http://yourserver/whatsapp/received

License

MIT

Configuration

set the following environment variables. Please use production codes, Test codes don't work with the whatsapp sandbox

TWILIO_AUTH_SID= <your twilio auth code> // it begins with AC
TWILIO_AUTH_TOKEN= <your twilio auth token>
#### Only for testing
TEST_SEND_NUMBER= <sandbox number>
TEST_RECIEVER_NUMBER= <your sandbox member number>

in medusa-config.js

add to your plugins list

///...other plugins
{
resolve:"medusa-plugin-whatsapp":
{
options:{
account_sid: process.env.TWILIO_AUTH_SID,
auth_token: process.env.TWILIO_AUTH_TOKEN,
whatsappHandlerInterface:"nameOftheHandlerService"
}
}
}

the whatsapp handler service need to implement the interface - WhatsappHandlerInterface

eg :

// please note you'll have to configure the message receive hooks in twilio to point to <Your server url>/whatsapp/received
export default class myService implements WhatsappHandlerInterface {
whatsappHandler (container: MedusaContainer, body: T, activeSession: WhatsappSession):Promise<MessagingResponse>; {
// your code to process the incoming message
}
// please note you'll have to configure the global conversation hooks in twilio to point to <Your server url>/whatsapp/prepare
whatsappConversationPrehookHandler: (
container: MedusaContainer,
body: T,
activeSession?: WhatsappSession
) => Promise<
| {
body?: string;
author?: string;
attributes?: Record<string, string>;

Sponsorship

If you find the Medusa-Plugin-Whatsapp valuable and would like to support its development, consider sponsoring us on GitHub. Your sponsorship will help us continue to improve and maintain this plugin, bringing two popular platforms together.

By sponsoring, you'll gain access to exclusive benefits and features, and you'll be making a difference in the developer community. Help us shape the future of this plugin by sponsoring today and will help facilitating more open source contributions from me.

You may also like

Browse all integrations

Build your own

Develop your own custom integraiton

Build your own integration with our API to speed up your processes. Make your integration available via npm for it to be shared in our Library with the broader Medusa community.

gift card interface

Ready to build your custom commerce setup?