Overview
This node allows you to set the presence state (typing or not typing) for a WhatsApp phone number using the Wuzapi WhatsApp API. It is useful when you want to programmatically show or hide the typing indicator in a chat, simulating user activity such as typing a message or recording audio.
Common scenarios:
- Indicating to a chat recipient that you are currently typing a message.
- Showing that you have stopped typing or paused.
- Displaying an audio recording indicator while composing a voice message.
Practical example:
You can use this node to update the presence state of a specific phone number to "Typing" when your automation starts composing a reply, and then switch it to "Not Typing" once the message is sent.
Properties
| Name | Meaning |
|---|---|
| Phone Number | The WhatsApp phone number for which to set the presence state (e.g., 5491155553934). |
| State | Presence state to set: - Typing ( composing): Show typing indicator.- Not Typing ( paused): Hide typing indicator. |
| Media Type | Type of media being composed: - None (empty string): Regular typing indicator. - Audio ( audio): Recording audio indicator. |
Output
The output JSON contains the response from the Wuzapi WhatsApp API after setting the presence state. This typically includes confirmation data about the presence update operation.
No binary data is output by this operation.
Dependencies
- Requires an active connection to the Wuzapi WhatsApp API.
- Requires an API key credential configured in n8n to authenticate requests to the Wuzapi service.
- The node uses the
/chat/presenceendpoint of the Wuzapi API to set presence states.
Troubleshooting
Common issues:
- Invalid or missing phone number format may cause the API request to fail.
- Incorrect or expired API credentials will result in authentication errors.
- Network connectivity problems can prevent communication with the Wuzapi API.
Error messages:
- Errors returned from the API will be included in the node's output if "Continue On Fail" is enabled.
- Typical error messages might include invalid phone number, unauthorized access, or malformed request.
Resolution tips:
- Verify the phone number is correctly formatted without extra characters.
- Ensure the API key credential is valid and has necessary permissions.
- Check network connectivity and firewall settings allowing outbound requests to the Wuzapi API.
Links and References
- Wuzapi WhatsApp API Documentation (example placeholder, replace with actual URL if available)
- WhatsApp Presence States Explanation (general WhatsApp API reference)