Inbound Socket

Inbound Socket mode allows you to send commands directly to FreeSWITCH and receive responses asynchronously. This mode is ideal for one-off operations, server queries, and administrative tasks.

Basic Example

import asyncio
from genesis import Inbound

async def uptime():
    async with Inbound("127.0.0.1", 8021, "ClueCon") as client:
        return await client.send("uptime")

async def main():
    response = await uptime()
    print(response)

asyncio.run(main())

How it works

The Inbound class acts as an asynchronous context manager:

  sequenceDiagram
    participant App
    participant FreeSWITCH
    
    App->>FreeSWITCH: Connect (ESL)
    FreeSWITCH-->>App: Authenticate
    App->>FreeSWITCH: send("command")
    FreeSWITCH-->>App: Response
    App->>FreeSWITCH: Disconnect

Use Cases

• Querying server status and statistics
• Executing administrative commands
• Triggering actions on FreeSWITCH
• Retrieving channel or call information
• One-time operations that don’t require persistent connections