Overview
This node allows users to perform various chat-related operations using the Wuzapi WhatsApp API. Specifically, the "Set Presence" operation lets you control the presence state of a WhatsApp user by setting typing or recording indicators for a given phone number. This is useful in scenarios where you want to simulate or indicate that a user is typing or recording audio in a chat, enhancing real-time interaction feedback.
Practical examples:
- Show a "typing" indicator when a bot or user is preparing a message.
- Hide the typing indicator once the message is sent.
- Indicate that audio is being recorded before sending a voice note.
Properties
| Name | Meaning |
|---|---|
| Phone Number | Phone number to set presence for (e.g., 5491155553934). |
| State | Presence state to set: - Typing (shows typing indicator) - Not Typing (hides typing indicator) |
| Media Type | Type of media being composed: - None (regular typing indicator) - Audio (recording audio indicator) |
Output
The output JSON contains the response from the Wuzapi WhatsApp API after setting the presence state. It typically includes confirmation or status information about the presence update request.
No binary data is output by this operation.
Dependencies
- Requires an API key credential for authenticating with the Wuzapi WhatsApp API.
- The node uses the
/chat/presenceendpoint of the Wuzapi API to set presence states. - Proper configuration of the API credentials in n8n is necessary.
Troubleshooting
Common issues:
- Invalid or incorrectly formatted phone numbers may cause the API call to fail.
- Missing or invalid API authentication will result in authorization errors.
- Setting an unsupported presence state or media type might not produce the expected behavior.
Error messages:
- Errors returned from the API will be included in the node's output if "Continue On Fail" is enabled.
- Typical error messages relate to invalid parameters or authentication failures.
Resolution tips:
- Verify the phone number format matches the expected international format without spaces or special characters.
- Ensure the API key credential is correctly configured and has sufficient permissions.
- Use only supported values for the "State" and "Media Type" properties.
Links and References
- Wuzapi WhatsApp API Documentation (example link; replace with actual if available)
- n8n documentation on API Credentials