Wapisimo icon

Wapisimo

Consume Wapisimo API

Overview

The Wapisimo node's "Get QR Code" operation retrieves the WhatsApp QR code for a specified WhatsApp account (identified by Phone ID) via the Wapisimo API. This is typically used to initiate or re-authenticate a WhatsApp session, such as when connecting a new device or re-linking an existing one.

Common scenarios:

  • Onboarding a new WhatsApp number to your automation.
  • Reconnecting a WhatsApp account after logout or session expiry.
  • Automating the process of fetching QR codes for user support or device management.

Example:
A business wants to automate the onboarding of customer service agents' WhatsApp numbers. The workflow uses this node to fetch the QR code, which is then sent to the agent for scanning.

Properties

Name Type Meaning
Phone ID String The ID of the WhatsApp account to get QR code for. Required.

Output

The node outputs a JSON object containing the response from the Wapisimo API. While the exact structure depends on the API, it typically includes fields such as:

{
  "qr": "data:image/png;base64,...",
  "status": "pending" // or other status indicators
}
  • qr: A data URL or base64 string representing the QR code image.
  • status: The current status of the WhatsApp connection/session.

If an error occurs and "Continue On Fail" is enabled, the output will be:

{
  "error": "Error message"
}

Dependencies

  • External Service: Requires access to the Wapisimo API.
  • API Key: You must configure valid Wapisimo API credentials in n8n under the name wapiSimoApi.
  • n8n Configuration: No additional configuration required beyond setting up credentials.

Troubleshooting

Common Issues:

  • Invalid or missing API key: Results in authentication errors. Ensure the API key is correctly set in n8n credentials.
  • Incorrect Phone ID: If the provided Phone ID does not exist or is not linked, the API may return a "not found" or similar error.
  • Network issues: Connectivity problems can cause request failures.

Common Error Messages:

  • "401 Unauthorized": Check your API key.
  • "404 Not Found": Verify the Phone ID.
  • "Request failed with status code ...": Review the error details for more information.

How to resolve:

  • Double-check credential setup in n8n.
  • Confirm the Phone ID is correct and active in your Wapisimo account.
  • Ensure your n8n instance has internet access.

Links and References

Discussion