Wapisimo Webhook icon

Wapisimo Webhook

Manage Wapisimo Webhooks
Join our community

Actions3

Overview

The Wapisimo Webhook node allows you to manage webhooks for a specific phone in the Wapisimo platform. The "Add Webhook" operation configures a new webhook URL that will receive notifications from Wapisimo for the specified phone. This is useful when you want to automate actions or integrate external systems based on events (such as incoming messages or status updates) from your Wapisimo-connected phone.

Common scenarios:

  • Automatically forwarding WhatsApp messages received by a phone to another system.
  • Triggering workflows in n8n or other platforms when certain events occur on your Wapisimo phone.
  • Integrating Wapisimo with CRMs, support desks, or notification services via webhooks.

Example:
You have a customer support phone managed by Wapisimo and want to notify your ticketing system whenever a new message arrives. You would use this node to register your ticketing system's webhook URL for that phone.

Properties

Name Type Meaning
Phone ID String The unique identifier of the phone for which you want to add a webhook.
Webhook URL String The URL endpoint that will receive webhook events from Wapisimo.

Output

The node outputs a single item per input, with the following structure in the json field:

  • On success:
    The response from the Wapisimo API after adding the webhook. This typically includes details about the newly created webhook (such as its ID, URL, and possibly status).
  • On error (if "Continue On Fail" is enabled): 
    {
  "error": "Error message text"
}

Dependencies

  • External Service: Requires access to the Wapisimo API.
  • API Key: You must provide valid Wapisimo API credentials (wapiSimoApi) in n8n.
  • n8n Configuration: No special configuration beyond setting up the credentials.

Troubleshooting

Common issues:

  • Invalid API Key: If the provided API key is incorrect or expired, the node will throw an authentication error. Ensure your credentials are up-to-date.
  • Invalid Phone ID: If the phone ID does not exist or is not associated with your account, the API will return an error.
  • Webhook URL Issues: If the webhook URL is unreachable or invalid, Wapisimo may reject the request or fail to deliver events.
  • Error Handling: If an error occurs and "Continue On Fail" is enabled, the output will contain an error field with the error message.

Common error messages:

  • "401 Unauthorized": Check your API key.
  • "404 Not Found": Verify the Phone ID.
  • "400 Bad Request": Check the format of the Webhook URL.

Links and References

Discussion