Skip to content
Nappai Documentation

WhatsApp Webhook

⚠️ DEPRECATION WARNING

This component is deprecated and will be removed in a future version of Nappai. Please migrate to the recommended alternative components.

The WhatsApp Webhook component lets you receive messages sent to your Twilio WhatsApp number. It listens for incoming messages and passes them into your Nappai workflow so you can process or respond to them.

How it Works

When a user sends a WhatsApp message to the Twilio number you have set up, Twilio forwards that message to a URL you provide. The WhatsApp Webhook component registers this URL as a webhook endpoint. Whenever Twilio posts a new message, the component captures the data, creates a simple Data object containing a confirmation message, and makes it available to the rest of your workflow. No additional processing is done inside the component; it simply confirms that the webhook is configured correctly.

Inputs

This component requires a Twilio WhatsApp Integration credential.

  1. Configure the credential in the Credentials section of Nappai.
  2. Select that credential in the component’s Credential field.

Input Fields

  • Description: Configure the webhook to receive messages from Twilio WhatsApp.

Outputs

  • Data: A Data object that contains a simple message indicating that the webhook configuration has been completed. This output can be used to trigger downstream actions or to log the status of the webhook.

Usage Example

  1. Create a Twilio WhatsApp Integration credential in Nappai’s Credentials section, providing your Twilio Account SID, Auth Token, and Phone Number.
  2. Add the WhatsApp Webhook component to your workflow.
  3. Select the credential you just created in the component’s Credential field.
  4. Enter a description (e.g., “Receive customer support messages”).
  5. Connect the component’s output to the next component in your workflow, such as a “Process Message” or “Send Response” component.
  6. Deploy the workflow. When a WhatsApp message arrives at your Twilio number, the webhook will trigger, and the workflow will continue with the data provided by the component.
  • WhatsApp Message Sender – Send automated replies or notifications via WhatsApp.
  • Twilio SMS Webhook – Receive SMS messages from Twilio.
  • Webhook Receiver – Generic component for handling HTTP webhook requests from any service.

Tips and Best Practices

  • Keep your Twilio credentials secure; never expose them in public repositories.
  • Test the webhook with Twilio’s console before deploying to production.
  • Use the component’s output to log webhook status or trigger alerts if the configuration fails.
  • If you need more advanced message handling, consider chaining this component with a natural language processing component.

Security Considerations

  • The component stores Twilio credentials in a protected credential store.
  • Ensure that only authorized users have access to the credential configuration page.
  • The data passed through the component is minimal; however, any message content received via Twilio should be treated as sensitive and handled according to your organization’s data privacy policies.