Documentation Index
Fetch the complete documentation index at: https://docs.lfautomatiza.com/llms.txt
Use this file to discover all available pages before exploring further.
Macros são sequências de ações pré-configuradas que o agente executa com um clique
durante uma conversa. Diferente de regras de automação (que disparam sozinhas a
partir de eventos), macros são acionadas manualmente.
Exemplo: macro “Escalar para N2” que executa em sequência:
- Adiciona label
n2
- Atribui equipe Suporte N2
- Envia mensagem “Sua solicitação foi escalada pro time técnico”
- Muda status pra Pending
Listar macros
GET /api/v1/accounts/{account_id}/macros
curl https://chat.lfautomatiza.com/api/v1/accounts/1/macros \
-H "api_access_token: $TOKEN"
Criar macro
POST /api/v1/accounts/{account_id}/macros
{
"name": "Escalar para N2",
"visibility": "global",
"actions": [
{ "action_name": "add_label", "action_params": ["n2"] },
{ "action_name": "assign_team", "action_params": [3] },
{ "action_name": "send_message", "action_params": ["Sua solicitação foi escalada pro time técnico. Em breve um especialista responde."] },
{ "action_name": "change_status", "action_params": ["pending"] }
]
}
| Campo | Tipo | Descrição |
|---|
name | string | Nome exibido pros agentes |
visibility | enum | global (todos da conta) ou personal (só quem criou) |
actions | array | Sequência de ações (mesma estrutura das automation_rules) |
Ações disponíveis
Mesmo conjunto das regras de automação:
assign_agent, assign_team, assign_best_agent, add_label, remove_label,
send_message, change_status, change_priority, send_attachment, mute_conversation,
snooze_conversation, add_private_note.
Detalhe / atualizar / excluir
GET /api/v1/accounts/{account_id}/macros/{id}
PATCH /api/v1/accounts/{account_id}/macros/{id}
DELETE /api/v1/accounts/{account_id}/macros/{id}
Executar macro numa conversa
POST /api/v1/accounts/{account_id}/macros/{id}/execute
curl -X POST https://chat.lfautomatiza.com/api/v1/accounts/1/macros/12/execute \
-H "api_access_token: $TOKEN" \
-H "Content-Type: application/json" \
-d '{ "conversation_ids": [1287, 1288, 1289] }'
| Campo | Descrição |
|---|
conversation_ids | Array de conversas onde executar a macro (1 ou múltiplas) |
Macros pessoais vs globais
visibility | Quem vê | Quem pode editar |
|---|
personal | Apenas o criador | Apenas o criador |
global | Todos os agentes da conta | Apenas administradores |
Códigos de resposta
| Código | Quando acontece |
|---|
200 OK | Listagem / leitura / atualização / execução |
201 Created | Macro criada |
204 No Content | Excluída |
403 Forbidden | Macro global sem ser admin / macro personal de outro agente |
