salvar_automacao
Create or update a CRM automation (funnel or general) by specifying entity ID, trigger ID, and optional actions, stage, or schedule.
Instructions
Criar ou atualizar uma automação (de funil ou geral) no Ploomes CRM.
Passe o ID para atualizar uma automação existente.
Observações:
1. entidade_id: EntityId da entidade base (confirmado via buscar_schema
em conta real: 1 = Cliente/Contacts, 2 = Negócio/Deals, 3 = Lead,
4 = Venda/Orders, 7 = Proposta/Quotes, 10 = Produto, 12 = Tarefa,
24 = Usuário, 36 = Registro de Interação, 66 = Documento). Use
buscar_schema/buscar_campos_entidades para confirmar na conta
específica — esses números podem variar por conta.
2. gatilho_id (TriggerId): obtenha com buscar_gatilhos_acoes_automacao.
3. etapa_id (TriggerDealStageId): obrigatório só para automação de funil
(gatilho vinculado a uma etapa específica). Use buscar_pipeline para
obter o StageId.
4. intervalo_unidade_id / intervalo_valor / data_inicio_repeticao: só
usados quando o gatilho for "periodicamente".
5. Uma automação tem um único gatilho, mas pode ter várias ações
executadas em sequência — a ordem da lista `acoes` é a ordem de
execução.
6. Cada item de `acoes` é um dicionário com os campos nativos de
AutomationAction. O campo obrigatório é ActionId (use
buscar_gatilhos_acoes_automacao). Os demais campos dependem do tipo
de ação:
- Editar campo (valor fixo): {"ActionId": X, "FieldKey": "deal_title", "StringValue": "Novo título"}
- Editar campo (puxar de campo vinculado via field-path): {"ActionId": X, "FieldKey": "...", "FieldPathId": 123}
- Enviar e-mail: {"ActionId": X, "EmailTemplateId": 123, "RecipientsEmailAddress": "a@b.com", "EmailSenderTypeId": 1}
- Criar tarefa: {"ActionId": X, "UserValueId": 456, "TaskDaysFromNow": 2}
- Finalizar negócio como perdido: {"ActionId": X, "LossReasonId": 789}
- Gerar documento: {"ActionId": X, "ShouldGenerateDocument": true}
Confirme os IDs e a combinação exata de campos testando em uma conta
de sandbox antes de aplicar em produção — a documentação interna da
API não audita com certeza todos os campos aceitos por tipo de ação.
7. Ao editar (passando `id`), reenviar `acoes` substitui a lista de ações
anterior — inclua todas as ações desejadas, não apenas as novas.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | ||
| acoes | No | ||
| etapa_id | No | ||
| filtro_id | No | ||
| gatilho_id | Yes | ||
| habilitada | No | ||
| entidade_id | Yes | ||
| intervalo_valor | No | ||
| intervalo_unidade_id | No | ||
| data_inicio_repeticao | No |