whatsapp-labels

What This Skill Does

The whatsapp-labels skill acts as a bridge between the OpenClaw agent and your WhatsApp Business session cache. It provides a standardized interface for interacting with your organizational tags. By leveraging this skill, the agent can query existing label definitions, understand how conversations are categorized, and retrieve specific lists of chats associated with those labels. It essentially allows the AI to perform management tasks on the CRM layer of your WhatsApp Business account without requiring manual input through the graphical interface.

Installation

To integrate this skill into your environment, utilize the OpenClaw package manager. Open your terminal and execute the following command:

clawhub install openclaw/skills/skills/marcosrippel/whatsapp-labels

Ensure that you have an active WhatsApp Business session initialized within your OpenClaw environment, as this skill relies on local cache files generated by the authentication process. If no labels have been created in your WhatsApp Business dashboard, the skill will return an empty list.

Use Cases

This skill is highly effective for CRM management and workflow automation. Use it to:

• Quickly segment customer communications based on custom tags (e.g., 'Pending Payment', 'Follow-up', 'VIP').
• Generate reports on the volume of chats within specific categories.
• Filter interactions to prioritize high-value or urgent clients.
• Cross-reference chat history with organizational labels to ensure nothing slips through the cracks.

Example Prompts

1. "Check my WhatsApp labels and tell me how many chats are marked as 'VIP Client'."
2. "Show me a list of all current tags available in my WhatsApp Business account."
3. "Which of my ongoing WhatsApp conversations are currently labeled as 'Pending Refund'?"

Tips & Limitations

• Session Dependencies: This tool requires a pre-authenticated WhatsApp Business session. It cannot fetch labels from a personal (non-business) account.
• Read-Only Focus: Currently, this skill is primarily designed for querying and retrieval. Ensure your expectations align with its read-only capabilities regarding the label metadata.
• Cache Sync: The accuracy of the results depends on the state of the local session cache. If you have recently updated labels in the WhatsApp mobile app, you may need to wait for the web session to sync before the agent can see the changes.
• Permission: Ensure your OpenClaw instance has proper access to the directory where the WhatsApp session cache is stored to avoid 'file access denied' errors during execution.