Scheduled actions

Scheduled actions are DELAYED_JOB jobs that run after a delay from the contact’s last incoming message. Execution depends on the current stage, active rules, and configured delay—not on an AI decision.

Scheduled actions do not inherit rules from the main set. Each stage must have its own rules or share a rule associated with multiple stages.

A rule can use execute_once to run only once per contact.

Scheduled HTTP Call

{
  "type": "HTTP_CALL",
  "delay_in_seconds": 3600,
  "url": "https://seu-endpoint/webhook",
  "auth": {
    "type": "bearer",
    "token": "SEU_TOKEN"
  },
  "method": "POST",
  "timeout": 10000,
  "run_ai_after": true,
  "error_message": "Fallback message.",
  "execute_once": false
}

type, delay_in_seconds, url, and method are required. auth, timeout, run_ai_after, error_message, and execute_once are optional.

Outgoing request

The endpoint receives an envelope containing the function arguments, project, and contact:

{
  "params": {},
  "query": {},
  "body": {
    "function_args": {},
    "project": {
      "id": 36,
      "account_id": 5,
      "inbox_id": 156
    },
    "contact": {
      "conversation_id": 17765,
      "source_id": "487",
      "identifier": "+5511999999999",
      "name": "Example contact",
      "configurations_set": "compra",
      "custom_infos": {},
      "additional_data": {},
      "file_ids": [],
      "vector_store_id": null
    }
  }
}

Response

The minimum response is:

{
  "output": "..."
}

output is required and must be a string. An empty response is treated as an error. The endpoint may also return continue_conversation, message_to_ai, and direct_messages, as described in HTTP Call. The AI is called again only when both conditions are true:

run_ai_after === true
continue_conversation !== false

Force Message

Force Message actions resume a conversation without an HTTP integration.

Message to the AI

FORCE_NEW_MESSAGE_TO_AI delivers the message as an instruction for the AI to write a response using the conversation history.

{
  "type": "FORCE_NEW_MESSAGE_TO_AI",
  "message": "Resume the conversation briefly.",
  "delay_in_seconds": 900,
  "execute_once": true
}

Direct message to the contact

FORCE_NEW_MESSAGE_TO_USER sends the text directly without AI rewriting.

{
  "type": "FORCE_NEW_MESSAGE_TO_USER",
  "message": "Hello, can I help with anything else?",
  "delay_in_seconds": 900
}

The rule is scheduled only when it is active and associated with the contact’s current stage.

Getting Started

Advanced Features

Scheduled actions

Scheduled actions

Scheduled HTTP Call

Outgoing request

Response

Force Message

Message to the AI

Direct message to the contact

​Scheduled actions

​Scheduled HTTP Call

​Outgoing request

​Response

​Force Message

​Message to the AI

​Direct message to the contact

Scheduled actions

Scheduled HTTP Call

Outgoing request

Response

Force Message

Message to the AI

Direct message to the contact