The MessageMedia Enterprise Webhooks code guide demonstrates how you can verify webhooks signed and sent to you by MessageMedia.

• Information
  • Slack and Mailing List
  • Bug Reports
  • Contributing
• Prerequisite
• Get Started
• API Documentation
• Need help?
• License

If you have any questions, comments, or concerns, please join our Slack channel: https://developers.messagemedia.com/collaborate/slack/

Alternatively you can email us at: [email protected]

If you discover a problem with the code guide, we would like to know about it. You can raise an issue or send an email to: [email protected]

We welcome your thoughts on how we could best provide you with SDKs that would simplify how you consume our services in your application. You can fork and create pull requests for any features you would like to see or raise an issue

To be able to use this SDK, you will need a public key provided by MessageMedia. You can find out how to do this by going through the Signature Key Management documentation. You can then make use of the Signature Key Management NodeJS SDK to create and manage your keys.

To keep this guide simple and easy to understand, we've used Express to set up a server which will monitor for incoming webhooks. You can setup your own production server and use it instead of the Express one if needed.

Create an empty directory for your project, let’s name it “testApp”. Now, open up your command prompt and clone this repository into the directory created. Run npm install to install the necessary packages.

Open up the index.js file and replace the placeholder that says PUBLIC_KEY_HERE with your public key. The result should look like this:

var publicKey = '-----BEGIN PUBLIC KEY-----\n'+
  'MIIabcdNBgkqhkiG9w0BAQ4AAOCA338AMIIBCgKCAQEAwISbN8vv0HeUCPN9o29xCUzCsh0ZUM+wdc3Gi3+DfyO4rPec1f/uxFbw0Dscw1iEA1dUfQ5eKhhsOIPdjk//gOGQbBVmQ8DhDcGVGWrHrE/n/K/x0ZkIae4n4eNobK96Ic/C4YmXf5LBUmgkOwUM+5VDPxe3rMnm/3TQdJzAcBMIzqNixzseCh4ICYMSahKnkNY5bJGf+8WbT0i+3mHQwvLacAub+wFH6hyT4I7FXOcXmR+HIyD8xwwYLmB4Yy+cMmiDcc1J9KX34C5apXM2A3f2mOtgfM0WSH2NpXmZmpXmzbkbIxEw90N3zERrDb2myJAHAD0MKQ7abcdxPen96dIDAQAB\n'+
  '-----END PUBLIC KEY-----';

The request line will need to be changed according to your callback url and request type. For instance, if your callback url is /captureData and the method type was PATCH then the resulting request line would look like this:

  verifier.update("PATCH /captureData HTTP/1.1" + date + body);

You are now ready to test the application. From the root directory of your application (where your index.js file is), run node index If all goes well, you should receive a true response which indicates the verification was a success.

Check out the full API documentation for more detailed information.

Please contact developer support at [email protected] or check out the developer portal at developers.messagemedia.com

Apache License. See the LICENSE file.