Actions148
- Send messages Actions
- Outbound Messages Actions
- WhatsApp Numbers Actions
- Groups Actions
- Channels Actions
- Chats Actions
- Chat Contacts Actions
- Chat Messages Actions
- Chat Files Actions
- Team Actions
- Labels Actions
- Departments Actions
- Files Actions
- Quick replies Actions
- Queue Actions
- WhatsApp session Actions
- WhatsApp profile Actions
- Business catalog Actions
- Campaigns Actions
- Meeting Links Actions
- User Status Actions
- Webhooks Actions
- Other Actions
Chat Contacts → Block Contacts
AI-generatedOverview
This node interacts with the WaliChat WhatsApp API to manage chat contacts, specifically allowing users to block one or more contacts on a selected WhatsApp number. Blocking contacts is useful in scenarios where you want to prevent receiving messages from certain phone numbers or restrict communication for compliance or moderation purposes.
Practical examples:
- A business wants to block spam or abusive contacts from messaging their WhatsApp business number.
- An organization needs to temporarily block specific customers or clients from contacting their support WhatsApp line.
- Managing contact lists by blocking outdated or irrelevant contacts automatically.
Properties
| Name | Meaning |
|---|---|
| WhatsApp Number | The ID of the WhatsApp number (device) on which the contacts will be blocked. |
| Contact Phone Numbers | One or more phone numbers (1-50) in international E164 format to be blocked on the WhatsApp number. |
Output
The node outputs JSON data representing the result of the block contacts operation. This typically includes confirmation of the contacts that were successfully blocked or any relevant status information returned by the WaliChat API.
No binary data output is indicated for this operation.
Dependencies
- Requires an active connection to the WaliChat WhatsApp API.
- Needs an API key credential configured in n8n for authentication with the WaliChat service.
- The WhatsApp number (device) must be registered and available in the WaliChat system.
Troubleshooting
Common issues:
- Invalid or unregistered WhatsApp number/device ID may cause failures.
- Incorrectly formatted contact phone numbers (not in E164 format) can lead to errors.
- Exceeding the maximum allowed contacts (more than 50) will likely cause rejection.
- Network or authentication errors if the API key is missing or invalid.
Error messages and resolutions:
- "Invalid device ID" — Verify the WhatsApp number ID is correct and loaded properly.
- "Invalid phone number format" — Ensure all contact numbers include the country code and follow E164 formatting.
- "Too many contacts" — Limit the number of contacts to 50 per request.
- "Authentication failed" — Check that the API key credential is correctly set up and has necessary permissions.
Links and References
- WaliChat Official API Documentation (for detailed API usage and contact management)
- E.164 Phone Number Formatting (to understand required phone number format)