whatsapp-dev

README

WhatsApp-Dev

Maildev but for the WhatsApp business API.

This API is mainly designed for 2 things:

1. Locally test whatsapp API code without all the hassle of the WhatsApp's testing phone number (handy if you work with multiple people)
2. Staging / Testing envourments where you freely want to test your whatsapp integration code but don't want to be scared of accedentially sending messages to real people or be limited to the testing API and have to change your api key every day.

Limitations / TODO

• Sending something other than text messages like images, videos, sticker, etc..
• Send status updates via the webhook
• Templates
  • Support Website, Phone number and Promo offer action buttons (currently only quick reply is supported)
  • Support Media header (currently only text is supported)

Local setup and run

go run . --webhook-url http://your-app-webhook.local:8080/webhook

Docker setup and run

docker build -t whatsapp-dev .

# IMPORTANT! If you don't do this docker will create a folder instaid of a file
touch db.sqlite

docker run \
  -it \
  --rm \
  -p 80:1090 \
  -v `pwd`/db.sqlite:/usr/src/app/db.sqlite \
  whatsapp-dev \
  app --webhook-url http://your-app-webhook.local:8080/api/webhook

Now visit http://localhost to see whatsapp-dev

Options:

name	flag	env	default
webhook url (required)	--webhook-url -w	WEBHOOK_URL
webhook verify token	--webhook-verify-token -t	WEBHOOK_VERIFY_TOKEN	Randomly generated
Secrets seed	--secrets-seed -s	SECRETS_SEED	fallback-secrets-seed
HTTP address	--http-addr -a	HTTP_ADDR	:3000
HTTP server username	--http-username -u	HTTP_USERNAME	No auth required if not defined
HTTP server password	--http-password -p	HTTP_PASSWORD	No auth required if not defined
Mocked phone number	--whatsapp-phone-number	WHATSAPP_PHONE_NUMBER	Randomly generated
Mocked phone number id	--whatsapp-phone-number-id	WHATSAPP_PHONE_NUMBER_ID	Randomly generated
Facebook Graph token	--facebook-graph-token	FACEBOOK_GRAPH_TOKEN	Randomly generated
Facebook developer app secret	--facebook-app-secret	FACEBOOK_APP_SECRET	Randomly generated

Note that all randomly generated values are generated using the secrets seed if you don't change your seed all randomly generated values will stay the same when restarting the service

From WhatsApp business API to this?

Replace https://graph.facebook.com with a instance of WhatsApp-Dev and assuming you have setup your instance of WhatsApp-Dev the same as the real api this should be all.

Note that if your instance of WhatsApp-Dev has different credentials then the real API you also need to change those.

It's recomment to use diffrent credentials for this and the real api.

Going from this to the real api?

Here is a rough outline of what you need todo:

• On developers.facebook.com create a new app
  • App kind: Other
  • App type: Company
• Add WhatsApp as product
• You will probably hit a roadblock here and need to verivy your facebook business
• Add a (real) phone number under Whatsapp > Api Setup
• Setup a webhook (that works. important!) under Whatsapp > Configuration
• Toggle the live mode within your API
• Add a creditcard to your facebook bussness here: business.facebook.com
  • Note the selected org MUST the same as the org used to created your facebook app earlier
  • Also add your creditcard under Accounts > Whatsapp Business-accounts

Now you should beable to send the hello_world template using your real phone number (note that this cost money 💸)

You can add new templates on this website business.facebook.com