Built for engineers
who ship voice

import os
import json
import websocket
from parlo import ParloClient

client = ParloClient(api_key=os.environ["PARLO_API_KEY"])

# ── 1. Create agent
agent = client.agents.create(
    name="support-agent",
    language="auto",
    voice="nova",
    instructions=(
        "You are a helpful multilingual support agent. "
        "Respond in the caller's language. Be concise."
    )
)
print(f"Agent: {agent.id}")  # agt_01j9k...

# ── 2. Outbound call
call = client.calls.create(
    agent_id=agent.id,
    to="+1-555-0100",
    from_="+1-555-0199",
    metadata={"ticket_id": "TKT-4411"},
    webhook="https://your-server.com/webhooks/parlo"
)
print(f"Call: {call.id}")  # call_01j9k...

# ── 3. WebSocket stream
def on_message(ws, message):
    msg = json.loads(message)
    if msg["type"] == "transcript.final":
        print(f"[{msg['lang']}] {msg['speaker']}: {msg['text']}")
    elif msg["type"] == "language.detected":
        print(f"Detected: {msg['language']}")
    elif msg["type"] == "call.ended":
        ws.close()

ws_app = websocket.WebSocketApp(
    f"wss://stream.parlo.ai/v1/calls/{call.id}",
    header=[f"Authorization: Bearer {os.environ['PARLO_API_KEY']}"],
    on_message=on_message
)
ws_app.run_forever()

package main

import (
    "fmt"
    "os"
    "github.com/parlo-ai/go-sdk/parlo"
)

func main() {
    client := parlo.New(os.Getenv("PARLO_API_KEY"))

    // ── 1. Create agent
    agent, err := client.Agents.Create(parlo.AgentParams{
        Name:         "support-agent",
        Language:     "auto",
        Voice:        "nova",
        Instructions: "You are a helpful multilingual support agent.",
    })
    if err != nil { panic(err) }
    fmt.Println("Agent:", agent.ID)

    // ── 2. Outbound call
    call, err := client.Calls.Create(parlo.CallParams{
        AgentID:  agent.ID,
        To:       "+1-555-0100",
        From:     "+1-555-0199",
        Metadata: map[string]any{"ticketId": "TKT-4411"},
        Webhook:  "https://your-server.com/webhooks/parlo",
    })
    if err != nil { panic(err) }
    fmt.Println("Call:", call.ID)

    // ── 3. WebSocket stream (goroutine)
    stream, err := client.Calls.Stream(call.ID)
    if err != nil { panic(err) }
    defer stream.Close()

    for msg := range stream.Messages() {
        switch msg.Type() {
        case parlo.EventTranscriptFinal:
            t := msg.(parlo.TranscriptEvent)
            fmt.Printf("[%s] %s: %s\n", t.Lang, t.Speaker, t.Text)
        case parlo.EventCallEnded:
            return
        }
    }
}

# ── 1. Create agent
curl -X POST https://api.parlo.ai/v1/agents \
  -H "Authorization: Bearer $PARLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "support-agent",
    "language": "auto",
    "voice": "nova",
    "instructions": "You are a helpful multilingual support agent."
  }'

# Response:
# { "id": "agt_01j9kxxxxxx", "name": "support-agent", "language": "auto" }

# ── 2. Start a call
curl -X POST https://api.parlo.ai/v1/calls \
  -H "Authorization: Bearer $PARLO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agt_01j9kxxxxxx",
    "to": "+1-555-0100",
    "webhook": "https://your-server.com/webhooks/parlo"
  }'

# ── 3. Fetch call status
curl https://api.parlo.ai/v1/calls/call_01j9kxxxxxx \
  -H "Authorization: Bearer $PARLO_API_KEY"

# ── 4. Get transcript
curl https://api.parlo.ai/v1/transcripts/call_01j9kxxxxxx \
  -H "Authorization: Bearer $PARLO_API_KEY"