/int-evo-crm

name: int-evo-crm
description: "Query and manage Evo AI CRM data via REST API. Use when you need to list/search contacts, conversations, messages, inboxes, pipelines (with stages and items), or labels. Supports filtering, pagination, creating/updating/deleting resources. Calls the CRM API directly with no third-party proxy."
metadata:
  openclaw:
    requires:
      env:
        - EVO_CRM_URL
        - EVO_CRM_TOKEN
      bins:
        - python3
    primaryEnv: EVO_CRM_TOKEN
    files:
      - "scripts/*"

Evo CRM

Interact with your Evo AI CRM instance directly via the REST API.

Setup (one-time)

1. Get your API access token from your CRM admin panel. 2. Set environment variables:

   EVO_CRM_URL=https://api.evoai.app
   EVO_CRM_TOKEN=your_api_access_token

Commands

Contacts

List contacts

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py contacts [--sort name] [--page 1]

Get contact details

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py contact <id>

Search contacts

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py search_contacts --q <term>

Filter contacts (advanced)

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py filter_contacts --payload '{"attribute_key":"city","filter_operator":"equal_to","values":["NYC"]}'

Create contact

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py create_contact --name "John Doe" [--email john@example.com] [--phone +5511999999999]

Update contact

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py update_contact <id> [--name "New Name"] [--email new@example.com] [--phone +5511999999999]

Delete contact

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py delete_contact <id>

Contact conversations

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py contact_conversations <id>

Contact notes

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py contact_notes <id>

Create contact note

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py create_contact_note <id> --content "Note text here"

Contact pipelines

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py contact_pipelines <id>

Conversations

List conversations

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py conversations [--status open] [--assignee_type all] [--inbox_id <id>] [--page 1]

Get conversation details

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py conversation <id>

Search conversations

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py search_conversations --q <term>

Filter conversations (advanced)

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py filter_conversations --payload '{"status":"open"}' [--page 1]

Conversation counts by status

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py conversation_meta [--status open] [--assignee_type all]

Create conversation

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py create_conversation --contact_id <id> --inbox_id <id>

Assign conversation

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py assign_conversation <id> --assignee_id <user_id>

Toggle conversation status

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py toggle_status <id> --status resolved

Toggle conversation priority

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py toggle_priority <id> --priority urgent

Mute/Unmute conversation

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py mute_conversation <id>
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py unmute_conversation <id>

Mark conversation as unread

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py mark_unread <id>

Send conversation transcript

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py send_transcript <id> --email user@example.com

Messages

List messages in conversation

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py messages <conversation_id>

Send message (or private note)

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py create_message <conversation_id> --content "Hello" [--private]

Update message

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py update_message <conversation_id> <message_id> --content "Updated text"

Delete message

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py delete_message <conversation_id> <message_id>

Retry failed message

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py retry_message <conversation_id> <message_id>

Inboxes

List all inboxes

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py inboxes

Get inbox details

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py inbox <id>

List inbox agents

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py inbox_agents <inbox_id>

Get assignable agents

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py assignable_agents <inbox_id>

List inbox message templates

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py inbox_templates <inbox_id>

Pipelines

List all pipelines

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipelines

Get pipeline details

python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipeline <id>

Pipeline stats

python3 /mnt/skills/user/int-