Regras de Automacao

Configure regras automaticas que executam acoes quando determinadas condicoes sao atendidas. Automacoes podem atribuir conversas, adicionar etiquetas, enviar emails e mais.

GET/api/v1/accounts/{account_id}/automation_rules

Lista todas as regras de automacao da conta.

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/automation_rules" \
  -H "api_access_token: YOUR_TOKEN" | jq .

200Lista de regras

json

{
  "payload": [
    {
      "id": 1,
      "name": "Auto-atribuir VIP",
      "description": "Atribui conversas de clientes VIP para equipe premium",
      "event_name": "conversation_created",
      "account_id": 1,
      "conditions": [...],
      "actions": [...]
    }
  ]
}

POST/api/v1/accounts/{account_id}/automation_rules

Cria uma nova regra de automacao.

Body

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Sim	Nome da regra
`description`	`string`	Nao	Descricao da regra
`event_name`	`string`	Sim	Evento gatilho: conversation_created, conversation_updated, message_created
`conditions`	`array`	Sim	Array de condicoes para ativar a regra
`actions`	`array`	Sim	Array de acoes a executar

bash

curl -X POST "https://chat.seudominio.com/api/v1/accounts/1/automation_rules" \
  -H "api_access_token: YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Auto-atribuir por inbox",
    "event_name": "conversation_created",
    "conditions": [
      {
        "attribute_key": "inbox_id",
        "filter_operator": "equal_to",
        "values": [1],
        "query_operator": null
      }
    ],
    "actions": [
      {
        "action_name": "assign_team",
        "action_params": [2]
      },
      {
        "action_name": "add_label",
        "action_params": ["whatsapp"]
      }
    ]
  }'

GET/api/v1/accounts/{account_id}/automation_rules/{id}

Retorna os detalhes de uma regra de automacao.

bash

curl -s "https://chat.seudominio.com/api/v1/accounts/1/automation_rules/1" \
  -H "api_access_token: YOUR_TOKEN" | jq .

PATCH/api/v1/accounts/{account_id}/automation_rules/{id}

Atualiza uma regra de automacao existente.

Body

Nome	Tipo	Obrigatorio	Descricao
`name`	`string`	Nao	Nome da regra
`conditions`	`array`	Nao	Condicoes atualizadas
`actions`	`array`	Nao	Acoes atualizadas

DELETE/api/v1/accounts/{account_id}/automation_rules/{id}

Remove uma regra de automacao.

bash

curl -X DELETE "https://chat.seudominio.com/api/v1/accounts/1/automation_rules/1" \
  -H "api_access_token: YOUR_TOKEN"

Condicoes e Acoes

Eventos Gatilho

Evento	Descricao
`conversation_created`	Quando uma nova conversa e criada
`conversation_updated`	Quando uma conversa e atualizada
`message_created`	Quando uma nova mensagem e recebida

Acoes Disponiveis

Acao	Descricao
`assign_agent`	Atribuir a um agente especifico
`assign_team`	Atribuir a uma equipe
`add_label`	Adicionar etiqueta
`remove_label`	Remover etiqueta
`send_email`	Enviar email de notificacao
`mute_conversation`	Silenciar notificacoes da conversa
`change_status`	Alterar status (open, resolved, pending)
`change_priority`	Alterar prioridade