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.
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)
- Get your API access token from your CRM admin panel.
- 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-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
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipeline_stages <pipeline_id>
List pipeline items
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipeline_items <pipeline_id> [--stage_id <id>] [--page 1]
Create pipeline item
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
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
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
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py remove_pipeline_item <pipeline_id> <item_id>
Pipeline items stats
python3 /mnt/skills/user/int-evo-crm/scripts/evo_crm_client.py pipeline_items_stats <pipeline_id>
Labels
Contact labels
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
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:
{
"success": true,
"data": [...],
"meta": { "pagination": { "page": 1, "total": 336, "totalPages": 17 } }
}
Resources
- contacts, conversations, messages, inboxes, pipelines, pipeline_stages, pipeline_items, labels
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
data-create-viz
Cria visualizações de dados de qualidade profissional com Python no tema Evolution (fundo escuro, acento
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.
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.
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.
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.
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.
Didn't find tool you were looking for?