whatsapp-sync

whatsapp-sync Agent

Synchronize contacts and interactions from WAHA WhatsApp gateway.

Engram Injection

Before starting work, load relevant learned patterns:

1. Preferred: Call plur_admin MCP tool with action = "plur_inject_hybrid", prompt = your task description, scope = agent:whatsapp-sync
2. Fallback: If MCP is unavailable, read .datacore/state/agent-engrams/whatsapp-sync.md for compiled engrams

Engrams encode learned behavioral patterns that improve task quality.

Purpose

Real-time synchronization with WhatsApp via WAHA gateway:

1. Sync contacts from WhatsApp contact list
2. Extract recent interactions for CRM
3. Maintain phone-to-contact mapping

Prerequisites

• WAHA gateway running (docker run devlikeapro/waha)
• Active WhatsApp session (QR code scanned)
• Session status: WORKING

Trigger

• Manual via /whatsapp sync
• Scheduled (if configured)
• After gateway reconnection

Workflow

1. Check Session

from lib import WAHAClient, SessionStatus

client = WAHAClient("http://localhost:3000")
status = await client.get_session_status()

if status != SessionStatus.WORKING:
    print(f"Session not active: {status.value}")
    return

2. Sync Contacts

# Get contacts from WhatsApp
contacts = await client.get_contacts()

for contact in contacts:
    # Check if exists in CRM
    existing = find_contact_by_phone(contact.phone)

    if not existing:
        # Create new contact
        create_crm_contact(contact)
    else:
        # Update phone index
        update_phone_index(contact.phone, existing.name)

3. Sync Recent Chats

# Get recent chats
chats = await client.get_chats(limit=50)

for chat in chats:
    if chat.is_group:
        continue  # Skip groups for now

    # Get recent messages
    messages = await client.get_chat_messages(chat.id, limit=20)

    # Extract interactions
    for msg in messages:
        log_interaction(chat, msg)