seven Voice for Active Workflow

Official remote agent for Active Workflow that places text-to-speech calls via the seven gateway.

---

Features

• Voice / Text-to-Speech Calls - Trigger automated phone calls from any Active Workflow scenario
• Credential or Env Auth - Pass the API key as user credential or as SEVEN_API_KEY environment variable
• Self-hosted Flask service - Runs alongside your Active Workflow instance with no external dependencies

Note: The Active Workflow remote-agent API does not support scheduling. The agent UI may show scheduling options - they are intentionally non-functional.

Prerequisites

• Python 3.8+
• An Active Workflow instance reachable from the agent host
• A seven account with API key (How to get your API key)

Installation

1. Clone and start the Flask agent

git clone https://github.com/seven-io/active-workflow-voice.git
cd active-workflow-voice
pip install -r requirements.txt
python3.8 main.py

The agent listens on http://localhost:5000/.

2. Expose the agent URL to Active Workflow

export REMOTE_AGENT_URL="http://localhost:5000/"

3. Run Active Workflow

docker run --network host \
  -e REMOTE_AGENT_URL=$REMOTE_AGENT_URL \
  -p 3000:3000 --rm \
  -v aw-data:/var/lib/postgresql/11/main \
  automaticmode/active_workflow

Configuration

Option A: User credential

In Active Workflow open /user_credentials/new and create:

Field	Value
Credential Name	seven_api_key
Credential Value	Your seven API key

Option B: Environment variable

Set SEVEN_API_KEY on the host running main.py and skip the credential step entirely.

Usage

Create a new agent in Active Workflow and pick the seven Voice agent type. The minimum option set is:

apiKey may also be omitted if SEVEN_API_KEY is exported on the agent host.

Support

Need help? Feel free to contact us or open an issue.

License

MIT