Skip to main content

​
Flows

Orbit Flows is a visual workflow builder that lets you design complex communication automations without writing code. Connect triggers, conditions, channels, and AI agents into multi-step workflows using a drag-and-drop interface.

​
What Are Flows?

Flows are directed graphs of nodes that execute in sequence or parallel based on conditions. Each node performs an action — sending a message, calling an API, running an AI agent, or evaluating a condition. 
Trigger → Condition → Send SMS → Wait → Check Response → Branch
                                                           ├── AI Agent
                                                           └── Human Handoff

​
Core Concepts

ConceptDescription
TriggerWhat starts the flow — incoming message, API call, schedule, or webhook
NodeA single step in the flow — send message, HTTP request, delay, condition
EdgeConnection between nodes defining execution order
BranchConditional logic that splits the flow based on data or responses
VariableDynamic data passed between nodes (e.g., user name, order ID)

​
Use Cases

  • Welcome series — onboard new users with a multi-step SMS + email sequence
  • Appointment reminders — send reminders 24h and 1h before, handle confirmations
  • Lead nurturing — qualify leads with AI, route hot leads to sales
  • Support escalation — try AI agent first, escalate to human if unresolved
  • Order updates — notify customers at each stage of fulfillment
  • Survey collection — send surveys post-interaction, analyze responses with AI

​
Create a Flow via API

curl -X POST https://orbit-api.devotel.io/api/v1/flows \
  -H "X-API-Key: dv_live_sk_..." \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Welcome Series",
    "trigger": {
      "type": "event",
      "event": "contact.created"
    },
    "nodes": [
      {
        "id": "send_welcome",
        "type": "send_message",
        "channel": "sms",
        "body": "Welcome to Acme, {{contact.name}}! Reply HELP for assistance."
      },
      {
        "id": "wait_1d",
        "type": "delay",
        "duration": "24h"
      },
      {
        "id": "send_followup",
        "type": "send_message",
        "channel": "email",
        "template_id": "tmpl_welcome_email",
        "variables": { "name": "{{contact.name}}" }
      }
    ],
    "edges": [
      { "from": "send_welcome", "to": "wait_1d" },
      { "from": "wait_1d", "to": "send_followup" }
    ]
  }'

​
Next Steps