telnyx-outgoing-call-skill

name	Telnyx Outgoing Call Skill
description	Instructions for an AI to initiate and manage phone calls via the TelnyxOpenClaw API.

Telnyx Outgoing Call Skill

This skill allows an AI assistant to initiate phone calls to users and carry out specific tasks via a telephone interface.

Capabilities

• Initiate a phone call to a specific number.
• Provide a task that the call AI will use to introduce itself.
• Automatically handle the transition from the task introduction to a back-and-forth conversation.

API Documentation

BASE URL: http://localhost:3023 (may differ)

POST /call

Initiates an outgoing call.

Request Body:

{
  "task": "The specific reason for the call (e.g., 'Remind the user about their dentist appointment')",
  "to": "[phone]" (optional, defaults to DEFAULT_TO_NUMBER in .env)
}

Workflow for the AI:

1. Identify Need: When you need to contact a user via phone (e.g., for a reminder, urgent notification, or follow-up).
2. Formulate Task: Write a concise task description. The call AI will use this to generate its own greeting.
3. Execute: Send a POST request to the /call endpoint.

How it works internally

1. The server receives the task.
2. An LLM generates a friendly, task-specific intro (e.g., "Hello, I'm calling to remind you about...").
3. The call is placed via Telnyx.
4. When answered, the intro is played.
5. The system then enters a recording loop, allowing for a natural conversation.
6. The user can press any key (DTMF) to stop a recording and force the AI to respond immediately.