WhatsApp Flows Tools

To use this example webhook server for prototyping WhatsApp Flows, follow these steps:

1. Configure Environment Variables: Create a .env file or set the following variables in your environment:
   • WEBHOOK_VERIFY_TOKEN: A custom string used to verify the webhook connection with Meta.
   • GRAPH_API_TOKEN: A Temporary access token obtained from the Meta for Developers dashboard under WhatsApp > API Setup.
   • FLOW_ID: The specific ID of the WhatsApp Flow you intend to interact with.
2. Run the Server: Start the Node.js server and identify its base URL.
3. Configure Meta Dashboard:
   • Append /webhook to your server URL (e.g., https://your-domain.com/webhook).
   • In the Meta for Developers dashboard, navigate to WhatsApp > Configuration.
   • In the Webhook section, click Edit.
   • Paste your URL and enter the value used for WEBHOOK_VERIFY_TOKEN in the Verify token field.
   • Click Verify and save.
   • Under Webhook fields, click Manage and ensure the messages field is selected.
4. Customize Logic: Modify server.js to implement your specific business logic for handling incoming webhook events.

# Required environment variables
WEBHOOK_VERIFY_TOKEN=your_chosen_token
GRAPH_API_TOKEN=your_meta_access_token
FLOW_ID=your_flow_id

This project provides a simple Node.js webhook implementation designed for prototyping with the WhatsApp Business Cloud API. It mirrors the official Meta webhook setup process, allowing you to receive and acknowledge incoming WhatsApp messages.

Environment Variables

You must configure the following environment variables before running the server:

• WEBHOOK_VERIFY_TOKEN: A custom string of your choice. This must match the token you provide in the Meta for Developers dashboard during the webhook verification step.
• GRAPH_API_TOKEN: Your WhatsApp access token. You can obtain a Temporary access token from the API Setup section under WhatsApp in your Meta for Developers app dashboard.

Deployment and Configuration Steps

1. Run the server: Start the Node.js application and identify its public URL.
2. Prepare the Webhook URL: Append /webhook to your server's base URL (e.g., https://your-domain.com/webhook).
3. Configure Meta Dashboard:
   • Navigate to your app on Meta for Developers.
   • Go to WhatsApp > Configuration.
   • In the Webhook section, click Edit.
   • Paste your URL into the Callback URL field.
   • Enter your WEBHOOK_VERIFY_TOKEN value into the Verify token field.
   • Click Verify and save.
4. Subscribe to Fields:
   • Under the Webhook fields section, click Manage.
   • Ensure the messages field is selected to receive message notifications.

Customization

To implement custom business logic (such as responding to specific messages), edit the server.js file in the project root.

This example provides a Node.js implementation of a Flow Endpoint specifically designed for the pre-approved loan Flow template.

Note: This project is intended for prototyping only and is not production-ready.

Setup Steps:

1. Generate Keys: Use the included script to create a private/public key pair for testing. You must then upload the public key to your business phone number as per the WhatsApp documentation.
2. Configure Environment: Set the PASSPHRASE and PRIVATE_KEY environment variables. Ensure multiline keys maintain correct line breaks.
3. Deploy: Run the server and provide its URL as your endpoint URL in the WhatsApp Flow configuration.
4. Customize Logic: Modify src/flow.js to implement your specific screen navigation logic.

# Generate key pair
node src/keyGenerator.js {passphrase}

# Example Environment Variables
export PASSPHRASE="my-secret"
export PRIVATE_KEY="-----[REPLACE THIS] BEGIN RSA PRIVATE KEY-----\nMIIE...\n...\n...xyz\n-----[REPLACE THIS] END RSA PRIVATE KEY-----"