evolution-api
impa365 제작
Web & Frontend Development요약
Complete WhatsApp automation via Evolution API v2.3 - instances, messages (text/media/polls/lists/buttons/status)
설명
이 스킬이 하는 일
Evolution API v2.3 is a self-hosted REST API for WhatsApp automation. It manages instances, sends all message types (text, media, polls, buttons, lists, status updates, voice notes), handles group administration, and integrates with multiple chatbot platforms and CRM tools. Supports six event transports and S3-compatible media storage.
Provides a single REST API surface for the full WhatsApp feature set plus built-in chatbot orchestration, eliminating the need to wire together separate messaging SDKs and bot frameworks.
사용 시점
- Broadcasting promotional messages to a validated contact list
- Routing inbound WhatsApp chats to human agents via Chatwoot
- Triggering order status notifications from an e-commerce backend
- Building a keyword-triggered support bot using Typebot or OpenAI
- Syncing WhatsApp group activity to an N8N automation workflow
예시 워크플로
User asks: Create a WhatsApp support instance with a Typebot chatbot and Chatwoot handoff
- 1
POST /instance/create with instanceName, qrcode: true, and inline webhook pointing to N8N
- 2
GET /instance/connect/{instance} to retrieve the QR code base64 for scanning
- 3
POST /typebot/create/{instance} with triggerType all and the Typebot flow URL and ID
- 4
POST /chatwoot/set/{instance} with account credentials, importContacts: true, and autoCreate: true
- 5
Verify connection with GET /instance/connectionState/{instance}
A connected WhatsApp instance that auto-responds via Typebot and escalates to human agents in Chatwoot
요구 사항
- EVO_API_URL environment variable (URL of your Evolution API server)
- EVO_GLOBAL_KEY environment variable (global admin API key from your Evolution API server)
- EVO_INSTANCE environment variable (name of the WhatsApp instance to use)
- EVO_API_KEY environment variable (instance-specific API key)
- WhatsApp account for QR code pairing
설치
clawhub install impa365/evolution-apiCLI 명령을 실행하거나, 프롬프트를 Claude Code, Cursor, Codex 등 사용하는 코딩 에이전트에 붙여넣으세요.