WhatsApp Business API Examples

This sample application demonstrates how to use the WhatsApp Business API to create and manage message templates. It is provided in two distinct versions depending on your development stage:

• Boilerplate: Use this version if you want a clean blueprint to start your own implementation of message templates using the WhatsApp Business API.
• Complete App: Use this version to see a fully functional sample application that builds upon the boilerplate to showcase real-world message template usage.

This sample application demonstrates how to implement WhatsApp Business Platform features for a fictitious online grocery store ('Markt') using the Meta-hosted Cloud API. It specifically showcases the following capabilities:

• Message Templates: Using pre-approved templates for business communication.
• Interactive Messages: Sending rich, actionable messages to customers.
• Webhooks: Handling incoming notifications and events from the WhatsApp API.

To set up and use this application, refer to the official guide: Building WhatsApp Message Templates for E-commerce.

This repository contains two versions of a sample application demonstrating how to send and manage media messages using the WhatsApp Business API:

• boilerplate: A foundational blueprint designed for developers to use as a starting point when building custom media message implementations.
• complete-app: A fully functional sample application built upon the boilerplate that showcases end-to-end media message workflows.

This repository provides two versions of a sample application demonstrating how to use the WhatsApp Business API to operate with QR Codes:

• boilerplate: A blueprint designed for developers to use as a starting point when building their own QR Code implementations with the WhatsApp Business API.
• complete-app: A full sample application built upon the boilerplate that showcases a complete implementation of QR Code usage.

Use the sam logs command to retrieve logs from your deployed Lambda functions directly in your terminal. This command works for any AWS Lambda function, not just those managed by SAM.

To fetch and follow (tail) the logs for a specific function:

sam logs -n HelloWorldFunction --stack-name bot-app --tail

You can emulate the AWS environment locally using the SAM CLI and Docker.

Build

Run sam build to install dependencies (from hello-world/package.json) and create a deployment package in the .aws-sam/build folder.

Invoke a Lambda function

To test a specific function with a JSON event (found in the events/ folder):

sam local invoke HelloWorldFunction --event events/event.json

Emulate API Gateway

To run the API locally on port 3000:

sam local start-api
# In another terminal, test the endpoint:
curl http://localhost:3000/

The API routes are defined in template.yaml under the Events property of each function. For example:

      Events:
        HelloWorld:
          Type: Api
          Properties:
            Path: /hello
            Method: get

Tests are located in the hello-world/tests directory and use the Mocha framework.

Unit Tests

1. Navigate to the function directory:

   cd hello-world

2. Install dependencies:

   npm install

3. Run the unit tests:

   npm run test

Integration Tests

Integration tests require the application stack to be deployed first. You must provide the stack name via the AWS_SAM_STACK_NAME environment variable:

AWS_SAM_STACK_NAME=<your-stack-name> npm run integ-test

cd hello-world
npm install
npm run test
AWS_SAM_STACK_NAME=<stack-name> npm run integ-test