disparo-asksuite
Extensao para auxiliar na criacao de disparos, fluxos, mensagens e integracoes com Asksuite, RD Station, WhatsApp, n8n e CRM.
Open source Open in the app JSON README (API)
About
Extensao para auxiliar na criacao de disparos, fluxos, mensagens e integracoes com Asksuite, RD Station, WhatsApp, n8n e CRM.
Details
- Kind
- Plugins
- Topic
- Productivity
- Publisher
- marcotuliobrz
- Origin
- gemini
- Category
- ferramentas
- Version
- 1.0.0
- Last push
- 2026-05-11T20:37:33Z
- Repository state
- ativo
- Language
- Python
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
marcotuliobrz/disparo-asksuite
README
# disparo-asksuite + asksuite-api
Repo com **duas skills** complementares para a Asksuite:
| Skill | Pasta | O que faz |
|---|---|---|
| **`disparo-asksuite`** | (raiz) | Disparo em massa via WhatsApp (`POST /api/v1/transmission-list`). Com normalização de telefones, batches de 300, pausas e retomada. |
| **`asksuite-api`** | `asksuite-api/` | Tudo o resto: atendimentos, histórico de mensagens, performance, leads, tags, atendentes, empresas, áudios, refresh de token. Cobre os 17 endpoints da Public API oficial (`api.asksuite.com/docs#/`) + extras de control.*. |
Ambas funcionam em qualquer LLM CLI (Claude Code, Gemini CLI, Codex) ou direto pelo terminal. Sem dependências externas além da stdlib do Python.
## Setup
```bash
cp exemplo.env .env
# edite .env com seu token e companyId
```
## Uso típico
```bash
# 1. Lista templates aprovados pra escolher qual usar
python listar_templates.py --token $ASKSUITE_TOKEN --company $ASKSUITE_COMPANY
# 2. Normaliza contatos (qualquer formato → +55...)
python normalizar_contatos.py --input contatos_brutos.txt --output contatos.txt
# 3. Dispara em batches de 300 com pausa de 60s
python disparar.py --token $ASKSUITE_TOKEN \
--template <PLATFORM_ID> \
--contatos contatos.txt \
--nome minha_campanha \
[--tag <TAG_ID>] [--params valor1 valor2]
# 4. Confere status
python verificar_status.py --token $ASKSUITE_TOKEN --transmission-id <ID>
```
## Uso com LLM CLI
### Claude Code
Coloca o diretório em `~/.claude/skills/disparo-asksuite/` ou usa o path direto. A CLI lê o frontmatter do `SKILL.md` e ativa automaticamente quando o assunto bate.
### Gemini CLI
Coloca em `~/.gemini/skills/disparo-asksuite/`. Em sessão:
```
ative a skill disparo-asksuite
```
### Codex / outras CLIs
Codex não tem skill nativa. Use uma destas:
- Cole o conteúdo do `SKILL.md` no system prompt
- Ou aponte: `@./SKILL.md me ajuda a disparar pra essa lista: [...]`
### Direto (sem LLM)
Os scripts são autossuficientes. Veja "Uso típico" acima.
A LLM segue o roteiro: pede token → lista templates → normaliza → dispara → verifica.
## Limites empíricos da Asksuite
- Máximo **300 mensagens por chamada** ao endpoint
- Resposta demora **60–70s** com batch de 300 (timeout HTTP precisa ser ≥180s)
- Pausa mínima entre batches: **30s** (padrão 60s)
Detalhes em [`SKILL.md`](SKILL.md).
## Skill `asksuite-api` — operações além de disparo
Para puxar atendimentos, histórico de mensagens, performance, leads, tags, atendentes, etc, use a pasta `asksuite-api/`:
```bash
# 1. Login (uma vez — cache em ~/.asksuite_token.json)
python asksuite-api/scripts/login.py --email seu@email --password "..."
# 2. Descobrir companyId
python asksuite-api/scripts/listar_companies.py
# 3. Operações
python asksuite-api/scripts/listar_atendimentos.py --company X --start 2026-05-01 --end 2026-05-07
python asksuite-api/scripts/historico.py --attendance-id <id>
python asksuite-api/scripts/performance.py --company X --start 2026-05-01 --end 2026-05-07
python asksuite-api/scripts/listar_atendentes.py --company X --humans-only
python asksuite-api/scripts/listar_tags.py --company X --type MANUAL
python asksuite-api/scripts/listar_tags.py --control --token <X-API-Key> # tags custom
```
Documentação completa em `asksuite-api/SKILL.md` e `asksuite-api/references/`:
- `auth.md` — login, refresh, headers, dois tipos de X-API-Key
- `public-api.md` — todos os 17 endpoints oficiais com schemas
- `control-api.md` — endpoints control.asksuite.com não-disparo
- `schemas.md` — Attendance, Message, Tag, Template, Lead, Reservation, Performance
- `recipes.md` — receitas prontas (paginação, history, performance daily, refresh, dump conversa)
- `errors-and-limits.md` — debug 401/403/429, rate limits, gotchas
## Segurança
- `.env` está no `.gitignore` — nunca commite credenciais
- Token Asksuite tem permissão total na conta — trate como senha de admin
- JWT da Public API é por usuário humano — vazamento expõe leitura total da operação
- Ao rotacionar token control.*, atualize todos os scripts/workflows que usam ANTES de revogar o antigo