Agent skill

int-evo-crm

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.

Stars 211
Forks 54

Install this agent skill to your Project

npx add-skill https://github.com/EvolutionAPI/evo-nexus/tree/main/.claude/skills/int-evo-crm

Metadata

Additional technical details for this skill

openclaw
{
    "files": [
        "scripts/*"
    ],
    "requires": {
        "env": [
            "EVO_CRM_URL",
            "EVO_CRM_TOKEN"
        ],
        "bins": [
            "python3"
        ]
    },
    "primaryEnv": "EVO_CRM_TOKEN"
}

SKILL.md

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

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

Get contact details

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

Search contacts

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

Filter contacts (advanced)

bash
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

bash
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

bash
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

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

Contact conversations

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

Contact notes

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

Create contact note

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

Contact pipelines

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

Conversations

List conversations

bash
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

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

Search conversations

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

Filter conversations (advanced)

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

Conversation counts by status

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

Create conversation

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

Assign conversation

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

Toggle conversation status

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

Toggle conversation priority

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

Mute/Unmute conversation

bash
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

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

Send conversation transcript

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

Messages

List messages in conversation

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

Send message (or private note)

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

Update message

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

Delete message

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

Retry failed message

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

Inboxes

List all inboxes

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

Get inbox details

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

List inbox agents

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

Get assignable agents

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

List inbox message templates

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

Pipelines

List all pipelines

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

Get pipeline details

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

Pipeline stats

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

List pipeline stages

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipeline_stages <pipeline_id>

List pipeline items

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipeline_items <pipeline_id> [--stage_id <id>] [--page 1]

Create pipeline item

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py create_pipeline_item <pipeline_id> --contact_id <id> --stage_id <id>

Move item to stage

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py move_item <pipeline_id> <item_id> --stage_id <target_stage_id>

Bulk move items

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py bulk_move_items <pipeline_id> --item_ids id1,id2,id3 --stage_id <target>

Remove pipeline item

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py remove_pipeline_item <pipeline_id> <item_id>

Pipeline items stats

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipeline_items_stats <pipeline_id>

Labels

Contact labels

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py contact_labels <contact_id>
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py add_contact_labels <contact_id> --labels label1,label2

Conversation labels

bash
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py conversation_labels <conversation_id>
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py add_conversation_labels <conversation_id> --labels label1,label2

Output

JSON to stdout. List responses include pagination metadata:

json
{
  "success": true,
  "data": [...],
  "meta": { "pagination": { "page": 1, "total": 336, "totalPages": 17 } }
}

Resources

  • contacts, conversations, messages, inboxes, pipelines, pipeline_stages, pipeline_items, labels

Expand your agent's capabilities with these related and highly-rated skills.

EvolutionAPI/evo-nexus

data-create-viz

Cria visualizações de dados de qualidade profissional com Python no tema Evolution (fundo escuro, acento

211 54
Explore
EvolutionAPI/evo-nexus

cs-customer-escalation

Empacota uma escalação para Devs, Produto ou Davidson com contexto completo. Use quando um bug precisa de atenção além do suporte normal, vários clientes reportam o mesmo problema, um cliente está ameaçando cancelar, ou um problema ficou sem resolução além do SLA. / Package an escalation for engineering, product, or leadership with full context. Use when a bug needs engineering attention beyond normal support, multiple customers report the same issue, a customer is threatening to churn, or an issue has sat unresolved past its SLA.

211 54
Explore
EvolutionAPI/evo-nexus

mkt-draft-content

Draft blog posts, social media, email newsletters, landing pages, press releases, and case studies with channel-specific formatting and SEO recommendations. Use when writing any marketing content, when you need headline or subject line options, or when adapting a message for a specific platform, audience, and brand voice.

211 54
Explore
EvolutionAPI/evo-nexus

gog-tasks

Create, manage, and prioritize tasks and todo items. Convert emails to tasks, set priorities (P0-P3) and categories (Work/Personal/Errands/Admin), review daily priorities, track blocked and overdue tasks. Use when user mentions tasks, todos, action items, or wants to convert emails to tasks. Requires confirmation before creating or deleting tasks.

211 54
Explore
EvolutionAPI/evo-nexus

discord-get-messages

Retrieve messages from Discord channels via the Discord API. Use this skill when the user wants to read, search, or analyze messages from a Discord channel.

211 54
Explore
EvolutionAPI/evo-nexus

cs-customer-research

Pesquisa multi-fonte sobre pergunta ou tópico de cliente com atribuição de fontes. Use quando um cliente pergunta algo que precisa ser verificado, investigando se um bug foi reportado antes, verificando o que foi dito anteriormente a uma conta específica, ou coletando contexto antes de redigir uma resposta. / Multi-source research on a customer question or topic with source attribution. Use when a customer asks something you need to look up, investigating whether a bug has been reported before, checking what was previously told to a specific account, or gathering background before drafting a response.

211 54
Explore

Didn't find tool you were looking for?

Be as detailed as possible for better results