@moltflow/skills 1.2.0 → 1.3.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/SKILL.md +58 -58
- package/package.json +1 -1
package/SKILL.md
CHANGED
|
@@ -1,12 +1,12 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: "WhatsApp Automation & A2A"
|
|
3
|
-
description: "MoltFlow — complete WhatsApp automation platform: sessions, messaging, groups, labels, webhooks, AI
|
|
4
|
-
metadata: {"openclaw":{"emoji":"📱","homepage":"https://
|
|
3
|
+
description: "MoltFlow — complete WhatsApp automation platform: sessions, messaging, groups, labels, webhooks, AI-powered replies, auto-feedback collection, intention detection, lead management, anti-spam safeguards, agent-to-agent protocol (JSON-RPC, encryption), and configurable rules."
|
|
4
|
+
metadata: {"openclaw":{"emoji":"📱","homepage":"https://waiflow.app","requires":{"env":["MOLTFLOW_API_KEY"]},"primaryEnv":"MOLTFLOW_API_KEY"}}
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# WhatsApp Automation & A2A
|
|
8
8
|
|
|
9
|
-
MoltFlow provides a complete WhatsApp automation API with managed sessions, group monitoring, AI-powered replies,
|
|
9
|
+
MoltFlow provides a complete WhatsApp automation API with managed sessions, group monitoring, AI-powered replies, auto-feedback collection, intention detection, lead management, and agent-to-agent communication.
|
|
10
10
|
|
|
11
11
|
## When to use
|
|
12
12
|
|
|
@@ -28,12 +28,12 @@ Use this skill when you need to:
|
|
|
28
28
|
## Setup
|
|
29
29
|
|
|
30
30
|
Env vars:
|
|
31
|
-
- `MOLTFLOW_API_KEY` (required) — API key from
|
|
32
|
-
- `MOLTFLOW_API_URL` (optional) — defaults to `https://
|
|
31
|
+
- `MOLTFLOW_API_KEY` (required) — API key from waiflow.app dashboard
|
|
32
|
+
- `MOLTFLOW_API_URL` (optional) — defaults to `https://apiv2.waiflow.app`
|
|
33
33
|
|
|
34
34
|
Authentication: `X-API-Key: $MOLTFLOW_API_KEY` header or `Authorization: Bearer $TOKEN` (JWT from login).
|
|
35
35
|
|
|
36
|
-
Base URL: `https://
|
|
36
|
+
Base URL: `https://apiv2.waiflow.app/api/v2`
|
|
37
37
|
|
|
38
38
|
---
|
|
39
39
|
|
|
@@ -42,21 +42,21 @@ Base URL: `https://api.moltflow.com/api/v2`
|
|
|
42
42
|
```bash
|
|
43
43
|
# List all sessions
|
|
44
44
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
45
|
-
https://
|
|
45
|
+
https://apiv2.waiflow.app/api/v2/sessions
|
|
46
46
|
|
|
47
47
|
# Create new session
|
|
48
48
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
49
49
|
-H "Content-Type: application/json" \
|
|
50
50
|
-d '{"name": "Main Line"}' \
|
|
51
|
-
https://
|
|
51
|
+
https://apiv2.waiflow.app/api/v2/sessions
|
|
52
52
|
|
|
53
53
|
# Get session details
|
|
54
54
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
55
|
-
https://
|
|
55
|
+
https://apiv2.waiflow.app/api/v2/sessions/{session_id}
|
|
56
56
|
|
|
57
57
|
# Delete session
|
|
58
58
|
curl -X DELETE -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
59
|
-
https://
|
|
59
|
+
https://apiv2.waiflow.app/api/v2/sessions/{session_id}
|
|
60
60
|
```
|
|
61
61
|
|
|
62
62
|
| Endpoint | Method | Description |
|
|
@@ -73,15 +73,15 @@ curl -X DELETE -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
73
73
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
74
74
|
-H "Content-Type: application/json" \
|
|
75
75
|
-d '{"session_id": "uuid", "chat_id": "1234567890@c.us", "message": "Hello!"}' \
|
|
76
|
-
https://
|
|
76
|
+
https://apiv2.waiflow.app/api/v2/messages/send
|
|
77
77
|
|
|
78
78
|
# List chats for a session
|
|
79
79
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
80
|
-
https://
|
|
80
|
+
https://apiv2.waiflow.app/api/v2/messages/chats/{session_id}
|
|
81
81
|
|
|
82
82
|
# Get chat messages
|
|
83
83
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
84
|
-
https://
|
|
84
|
+
https://apiv2.waiflow.app/api/v2/messages/chat/{session_id}/{chat_id}
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
| Endpoint | Method | Description |
|
|
@@ -96,23 +96,23 @@ curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
96
96
|
```bash
|
|
97
97
|
# List monitored groups
|
|
98
98
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
99
|
-
https://
|
|
99
|
+
https://apiv2.waiflow.app/api/v2/groups
|
|
100
100
|
|
|
101
101
|
# List available WhatsApp groups
|
|
102
102
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
103
|
-
https://
|
|
103
|
+
https://apiv2.waiflow.app/api/v2/groups/available/{session_id}
|
|
104
104
|
|
|
105
105
|
# Add group to monitor
|
|
106
106
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
107
107
|
-H "Content-Type: application/json" \
|
|
108
108
|
-d '{"session_id": "uuid", "wa_group_id": "123456@g.us", "monitor_mode": "first_message"}' \
|
|
109
|
-
https://
|
|
109
|
+
https://apiv2.waiflow.app/api/v2/groups
|
|
110
110
|
|
|
111
111
|
# Update monitoring settings
|
|
112
112
|
curl -X PATCH -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
113
113
|
-H "Content-Type: application/json" \
|
|
114
114
|
-d '{"monitor_mode": "keyword", "monitor_keywords": ["looking for", "need help"]}' \
|
|
115
|
-
https://
|
|
115
|
+
https://apiv2.waiflow.app/api/v2/groups/{group_id}
|
|
116
116
|
```
|
|
117
117
|
|
|
118
118
|
| Endpoint | Method | Description |
|
|
@@ -131,15 +131,15 @@ curl -X PATCH -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
131
131
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
132
132
|
-H "Content-Type: application/json" \
|
|
133
133
|
-d '{"name": "VIP", "color": "#00FF00"}' \
|
|
134
|
-
https://
|
|
134
|
+
https://apiv2.waiflow.app/api/v2/labels
|
|
135
135
|
|
|
136
136
|
# Sync label to WhatsApp Business
|
|
137
137
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
138
|
-
"https://
|
|
138
|
+
"https://apiv2.waiflow.app/api/v2/labels/{label_id}/sync?session_id={session_id}"
|
|
139
139
|
|
|
140
140
|
# Import labels from WhatsApp Business
|
|
141
141
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
142
|
-
"https://
|
|
142
|
+
"https://apiv2.waiflow.app/api/v2/labels/sync-from-whatsapp?session_id={session_id}"
|
|
143
143
|
```
|
|
144
144
|
|
|
145
145
|
| Endpoint | Method | Description |
|
|
@@ -156,11 +156,11 @@ curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
156
156
|
```bash
|
|
157
157
|
# List webhooks
|
|
158
158
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
159
|
-
https://
|
|
159
|
+
https://apiv2.waiflow.app/api/v2/webhooks
|
|
160
160
|
|
|
161
161
|
# Test webhook
|
|
162
162
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
163
|
-
https://
|
|
163
|
+
https://apiv2.waiflow.app/api/v2/webhooks/{webhook_id}/test
|
|
164
164
|
```
|
|
165
165
|
|
|
166
166
|
| Endpoint | Method | Description |
|
|
@@ -180,15 +180,15 @@ curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
180
180
|
# Queue voice message for transcription
|
|
181
181
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
182
182
|
-d '{"message_id": "uuid-of-voice-message"}' \
|
|
183
|
-
https://
|
|
183
|
+
https://apiv2.waiflow.app/api/v2/ai/voice/transcribe
|
|
184
184
|
|
|
185
185
|
# Check transcription status
|
|
186
186
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
187
|
-
https://
|
|
187
|
+
https://apiv2.waiflow.app/api/v2/ai/voice/status/{task_id}
|
|
188
188
|
|
|
189
189
|
# Get transcript
|
|
190
190
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
191
|
-
https://
|
|
191
|
+
https://apiv2.waiflow.app/api/v2/ai/messages/{message_id}/transcript
|
|
192
192
|
```
|
|
193
193
|
|
|
194
194
|
## 7. AI — Knowledge Base (RAG)
|
|
@@ -197,15 +197,15 @@ curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
197
197
|
# Search knowledge base
|
|
198
198
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
199
199
|
-d '{"query": "return policy", "top_k": 5}' \
|
|
200
|
-
https://
|
|
200
|
+
https://apiv2.waiflow.app/api/v2/ai/knowledge/search
|
|
201
201
|
|
|
202
202
|
# List knowledge sources
|
|
203
203
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
204
|
-
https://
|
|
204
|
+
https://apiv2.waiflow.app/api/v2/ai/knowledge/sources
|
|
205
205
|
|
|
206
206
|
# Delete knowledge source
|
|
207
207
|
curl -X DELETE -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
208
|
-
https://
|
|
208
|
+
https://apiv2.waiflow.app/api/v2/ai/knowledge/{source_id}
|
|
209
209
|
```
|
|
210
210
|
|
|
211
211
|
## 8. AI — Style Profiles (Learn Mode)
|
|
@@ -214,15 +214,15 @@ curl -X DELETE -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
214
214
|
# Train style profile from message history
|
|
215
215
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
216
216
|
-d '{"contact_id": "optional-contact-jid"}' \
|
|
217
|
-
https://
|
|
217
|
+
https://apiv2.waiflow.app/api/v2/ai/style/train
|
|
218
218
|
|
|
219
219
|
# Check training status
|
|
220
220
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
221
|
-
https://
|
|
221
|
+
https://apiv2.waiflow.app/api/v2/ai/style/status/{task_id}
|
|
222
222
|
|
|
223
223
|
# Get / list / delete style profiles
|
|
224
224
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
225
|
-
https://
|
|
225
|
+
https://apiv2.waiflow.app/api/v2/ai/style/profiles
|
|
226
226
|
```
|
|
227
227
|
|
|
228
228
|
## 9. AI — Reply Generation
|
|
@@ -231,11 +231,11 @@ curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
231
231
|
# Generate AI reply (uses RAG + style)
|
|
232
232
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
233
233
|
-d '{"contact_id": "jid", "context": "customer question", "use_rag": true, "apply_style": true}' \
|
|
234
|
-
https://
|
|
234
|
+
https://apiv2.waiflow.app/api/v2/ai/ai/generate-reply
|
|
235
235
|
|
|
236
236
|
# Preview AI reply (no usage tracking)
|
|
237
237
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
238
|
-
"https://
|
|
238
|
+
"https://apiv2.waiflow.app/api/v2/ai/ai/preview?contact_id=jid&context=question&use_rag=true&apply_style=true"
|
|
239
239
|
```
|
|
240
240
|
|
|
241
241
|
### AI API Reference
|
|
@@ -268,15 +268,15 @@ curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
268
268
|
```bash
|
|
269
269
|
# Get full configuration
|
|
270
270
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
271
|
-
https://
|
|
271
|
+
https://apiv2.waiflow.app/api/v2/agent/bootstrap
|
|
272
272
|
|
|
273
273
|
# Get your public key (auto-generates if none)
|
|
274
274
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
275
|
-
https://
|
|
275
|
+
https://apiv2.waiflow.app/api/v2/agent/public-key
|
|
276
276
|
|
|
277
277
|
# Rotate keypair
|
|
278
278
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
279
|
-
https://
|
|
279
|
+
https://apiv2.waiflow.app/api/v2/agent/rotate-keys
|
|
280
280
|
```
|
|
281
281
|
|
|
282
282
|
### Discover agents
|
|
@@ -284,17 +284,17 @@ curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
284
284
|
```bash
|
|
285
285
|
# Resolve phone to MoltFlow agent
|
|
286
286
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
287
|
-
https://
|
|
287
|
+
https://apiv2.waiflow.app/api/v2/agents/resolve/+1234567890
|
|
288
288
|
|
|
289
289
|
# List peers
|
|
290
290
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
291
|
-
https://
|
|
291
|
+
https://apiv2.waiflow.app/api/v2/agents/peers
|
|
292
292
|
|
|
293
293
|
# Update trust level (discovered, verified, blocked)
|
|
294
294
|
curl -X PATCH -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
295
295
|
-H "Content-Type: application/json" \
|
|
296
296
|
-d '{"trust_level": "verified"}' \
|
|
297
|
-
https://
|
|
297
|
+
https://apiv2.waiflow.app/api/v2/agents/peers/{peer_id}/trust
|
|
298
298
|
```
|
|
299
299
|
|
|
300
300
|
### Send A2A messages (JSON-RPC 2.0)
|
|
@@ -311,7 +311,7 @@ curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
311
311
|
},
|
|
312
312
|
"id": "1"
|
|
313
313
|
}' \
|
|
314
|
-
https://
|
|
314
|
+
https://apiv2.waiflow.app/api/v2/a2a
|
|
315
315
|
```
|
|
316
316
|
|
|
317
317
|
### Content policy
|
|
@@ -319,19 +319,19 @@ curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
319
319
|
```bash
|
|
320
320
|
# Get policy settings
|
|
321
321
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
322
|
-
https://
|
|
322
|
+
https://apiv2.waiflow.app/api/v2/a2a-policy/settings
|
|
323
323
|
|
|
324
324
|
# Update policy
|
|
325
325
|
curl -X PUT -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
326
326
|
-H "Content-Type: application/json" \
|
|
327
327
|
-d '{"block_api_keys": true, "block_credit_cards": true, "block_emails": false}' \
|
|
328
|
-
https://
|
|
328
|
+
https://apiv2.waiflow.app/api/v2/a2a-policy/settings
|
|
329
329
|
|
|
330
330
|
# Test content against policy
|
|
331
331
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
332
332
|
-H "Content-Type: application/json" \
|
|
333
333
|
-d '{"content": "My API key is sk-abc123"}' \
|
|
334
|
-
https://
|
|
334
|
+
https://apiv2.waiflow.app/api/v2/a2a-policy/test
|
|
335
335
|
```
|
|
336
336
|
|
|
337
337
|
### A2A API Reference
|
|
@@ -373,24 +373,24 @@ curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
373
373
|
"include_keywords": ["great", "excellent"],
|
|
374
374
|
"languages": []
|
|
375
375
|
}' \
|
|
376
|
-
https://
|
|
376
|
+
https://apiv2.waiflow.app/api/v2/reviews/collectors
|
|
377
377
|
|
|
378
378
|
# Trigger manual scan
|
|
379
379
|
curl -X POST -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
380
|
-
https://
|
|
380
|
+
https://apiv2.waiflow.app/api/v2/reviews/collectors/{id}/run
|
|
381
381
|
|
|
382
382
|
# List reviews
|
|
383
383
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
384
|
-
"https://
|
|
384
|
+
"https://apiv2.waiflow.app/api/v2/reviews?approved_only=false&limit=50"
|
|
385
385
|
|
|
386
386
|
# Approve review
|
|
387
387
|
curl -X PATCH -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
388
388
|
-d '{"is_approved": true}' \
|
|
389
|
-
https://
|
|
389
|
+
https://apiv2.waiflow.app/api/v2/reviews/{id}
|
|
390
390
|
|
|
391
391
|
# Export testimonials as HTML
|
|
392
392
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
393
|
-
"https://
|
|
393
|
+
"https://apiv2.waiflow.app/api/v2/reviews/testimonials/export?format=html"
|
|
394
394
|
```
|
|
395
395
|
|
|
396
396
|
### Reviews API Reference
|
|
@@ -416,24 +416,24 @@ curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
|
416
416
|
```bash
|
|
417
417
|
# Login
|
|
418
418
|
curl -X POST -d '{"email": "user@example.com", "password": "..."}' \
|
|
419
|
-
https://
|
|
419
|
+
https://apiv2.waiflow.app/api/v2/auth/login
|
|
420
420
|
|
|
421
421
|
# Get current user
|
|
422
422
|
curl -H "Authorization: Bearer $TOKEN" \
|
|
423
|
-
https://
|
|
423
|
+
https://apiv2.waiflow.app/api/v2/auth/me
|
|
424
424
|
|
|
425
425
|
# Create API key
|
|
426
426
|
curl -X POST -H "Authorization: Bearer $TOKEN" \
|
|
427
427
|
-d '{"name": "Production Key", "expires_in_days": 90}' \
|
|
428
|
-
https://
|
|
428
|
+
https://apiv2.waiflow.app/api/v2/api-keys
|
|
429
429
|
|
|
430
430
|
# Revoke key
|
|
431
431
|
curl -X DELETE -H "Authorization: Bearer $TOKEN" \
|
|
432
|
-
https://
|
|
432
|
+
https://apiv2.waiflow.app/api/v2/api-keys/{id}
|
|
433
433
|
|
|
434
434
|
# Rotate key
|
|
435
435
|
curl -X POST -H "Authorization: Bearer $TOKEN" \
|
|
436
|
-
https://
|
|
436
|
+
https://apiv2.waiflow.app/api/v2/api-keys/{id}/rotate
|
|
437
437
|
```
|
|
438
438
|
|
|
439
439
|
| Endpoint | Method | Description |
|
|
@@ -451,23 +451,23 @@ curl -X POST -H "Authorization: Bearer $TOKEN" \
|
|
|
451
451
|
```bash
|
|
452
452
|
# Current period usage
|
|
453
453
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
454
|
-
https://
|
|
454
|
+
https://apiv2.waiflow.app/api/v2/usage/current
|
|
455
455
|
|
|
456
456
|
# Daily breakdown
|
|
457
457
|
curl -H "X-API-Key: $MOLTFLOW_API_KEY" \
|
|
458
|
-
"https://
|
|
458
|
+
"https://apiv2.waiflow.app/api/v2/usage/daily?days=30"
|
|
459
459
|
|
|
460
460
|
# List plans
|
|
461
|
-
curl https://
|
|
461
|
+
curl https://apiv2.waiflow.app/api/v2/billing/plans
|
|
462
462
|
|
|
463
463
|
# Create checkout session
|
|
464
464
|
curl -X POST -H "Authorization: Bearer $TOKEN" \
|
|
465
465
|
-d '{"plan": "pro", "cycle": "monthly", "success_url": "https://...", "cancel_url": "https://..."}' \
|
|
466
|
-
https://
|
|
466
|
+
https://apiv2.waiflow.app/api/v2/billing/checkout
|
|
467
467
|
|
|
468
468
|
# Billing portal
|
|
469
469
|
curl -H "Authorization: Bearer $TOKEN" \
|
|
470
|
-
https://
|
|
470
|
+
https://apiv2.waiflow.app/api/v2/billing/portal
|
|
471
471
|
```
|
|
472
472
|
|
|
473
473
|
| Endpoint | Method | Description |
|
package/package.json
CHANGED