piusalfred / whatsapp

golang wrapper for whatsapp cloud api

whatsapp

NOTE: This is a work in progress. The API is not yet stable and is subject to change.

implemented

• send text message
• send image message
• send location message
• send contact message
• send template message
• react to message
• mark message as read
• webhooks

SETUP

pre requisites

To be able to test/use this api you need Access Token, Phone number ID and Business ID. For that tou need to register as a Meta Developer. You can register here https://developers.facebook.com/docs/development/register

Then create an application here https://developers.facebook.com/docs/development/create-an-app and configre it to enable access to WhatsApp Business Cloud API.

You can manage your apps here https://developers.facebook.com/apps/

From Whatsapp Developer Dashboard you can try and send a test message to your phone number. to be sure that everything is working fine before you start using this api.

When all the above is done you can start using this api.

whatsapp's Issues

live testing and refactoring

core library implementation

Add Documentation And Add Set Secret Func For Weebhook Listener

Create documentation for its use.

REFACTOR: use builder pattern to simplify building complex messages.

Some messages are complex and there is no single way of building them. Examples of these are template messages and interactive messages.

Index value is omitted on request payload, if index value is 0.

I am passing button with index 0 in template message but in request payload its omitted.

buttonParams := []*models.TemplateParameter{{
	Type: "text",
	Text: "1234",
}}
components := []*models.TemplateComponent{
	{
	    Type:       "button",
	    SubType:    "url",
	    Index:      0,
	    Parameters: buttonParams,
	},
}

Generated payload

{"messaging_product":"whatsapp","to":"+***********","recipient_type":"individual","type":"template","template":{"name":"templ1","language":{"code":"en_US"},"components":[{"type":"button","sub_type":"url","parameters":[{"type":"text","text":"1234"}]}]}}

I debugged issue and found that its because of `omitempty` defined in TemplateComponent struct.

media management implementation

messaging implementation

add a stateful api client for ease of use.

@bcmmbaga and @Hopertz you wanted something like this?

https://github.com/piusalfred/whatsapp/blob/cbe96e3c5261330c4b9d3dd63bd6678f5ea6094d/whatsapp.go#L75-L288

qr code management

Impemetation of QR codes management

webhooks implementation

get started examples

documentation refactoring

commandline implememtation