WhatsApi icon

WhatsApi

Connect with WhatApp HTTP API

Overview

This node connects to a WhatsApp HTTP API service to retrieve the list of blocked numbers associated with a specific WhatsApp session (phone). It is useful for scenarios where you need to manage or audit contacts that have been blocked in a WhatsApp account, such as customer support systems, compliance checks, or contact management automation.

For example, a user might want to automatically fetch and log all blocked contacts from their WhatsApp business account to ensure no important clients are accidentally blocked.

Properties

Name Meaning
Phone The WhatsApp session ID (phone number) for which to retrieve the blocked number list. This is required and typically set from credentials.

Output

The node outputs JSON data containing the list of blocked numbers for the specified WhatsApp session. The exact structure depends on the WhatsApp API response but generally includes details about each blocked contact such as phone number identifiers.

No binary data output is indicated by the source code.

Dependencies

  • Requires connection to a WhatsApp HTTP API service.
  • Needs an API URL and authentication credentials configured in n8n (e.g., an API key or token).
  • The node uses a bundled OpenAPI specification to define its properties and requests.

Troubleshooting

  • Common issues:

    • Invalid or missing session ID (Phone property) will cause the request to fail.
    • Incorrect API URL or authentication credentials will result in connection errors.
    • Network issues or WhatsApp API downtime can cause timeouts or failed requests.
  • Error messages:

    • Authentication failures usually indicate invalid or expired API tokens; verify and update credentials.
    • "Not Found" or similar errors may mean the session ID does not exist or is incorrect.
    • JSON parsing errors could indicate unexpected API responses; check API version compatibility.

Links and References

Discussion