flow-crm
Interact with FlowDeck CRM API (clients, deals, proposals, receivables, expenses, contacts). Use for all CRM operations via the FlowDeck REST API through Supabase Edge Functions.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/araujodgdev/flow-crmFlowDeck CRM API
Interact with the FlowDeck CRM module via the REST API gateway
(base URL: https://<supabase_url>/functions/v1/api-gateway).
Usage
Run the script using the absolute path (do NOT cd to the skill directory):
uv run ~/.codex/skills/flow-crm/scripts/flow_api.py <action> <resource> [options]
Important: Always run from the user's current working directory so any output files are saved where the user is working.
Actions
| Action | Description | Example |
|---|---|---|
list | List resources (paginated) | uv run ... list clients --limit 50 |
get | Get single resource | uv run ... get clients --id <uuid> |
create | Create resource | uv run ... create clients --data '{"name":"Acme"}' |
update | Update resource | uv run ... update clients --id <uuid> --data '{"name":"Acme Inc"}' |
delete | Delete resource | uv run ... delete clients --id <uuid> |
Client Creation Workflow (mandatory)
When creating a client (create clients), the API only requires name. However, you MUST proactively ask the user about every available field BEFORE calling the API. Collect as much data as possible, then build the payload. Even if the user skips many fields, you must have asked.
Ask about these fields (use the Portuguese/Portuñol terms the user will recognize):
- Tipo —
client,supplier, orboth(default:client) - Empresa — Company name
- Email — Main contact email
- Email financeiro — Finance department email (
finance_email) - Telefone — Phone number
- CPF/CNPJ — Document (Brazilian tax ID)
- Website — Company website
- Endereço — Physical address
- País — Country (
country) - Código IBGE da cidade —
city_ibge_code - Status —
active,inactive, orlead(default:active) - Observações — Notes
Present these as a single structured block of questions (not one-by-one), e.g:
Antes de criar o cliente, preciso preencher algumas informações. Me diga o que souber:
- Tipo: [client/supplier/both]
- Empresa:
- Email:
- Email financeiro:
- Telefone:
- CPF/CNPJ:
- Website:
- Endereço:
- País:
- Código IBGE:
- Observações:
(Pule os que não souber.)
If the user responds with partial data, use what they gave and leave the rest blank — but never skip asking first. Then build the --data JSON with all collected fields and create the client.
CRM Resources
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-araujodgdev-flow-crm": {
"enabled": true,
"auto_update": true
}
}
}