technickai/quo

Quo 📞

Query your Quo (formerly OpenPhone) business phone — calls, texts, contacts, transcripts.

Setup

API key from my.quo.com → Settings → API. Configure via gateway under skills.entries.quo.apiKey. OpenClaw injects it as QUO_API_KEY automatically.

What Users Ask

• "What's my Quo number?"
• "Show recent conversations"
• "Get the transcript from that call"
• "What was the summary of my call with [person]?"
• "List my business contacts"
• "Send a text to [number]"
• "Show my recent calls with [number]"
• "Any missed calls today?"
• "Who called the office?"
• "Text [person] from my work number"
• "Check my voicemails"
• "What messages came in on the business line?"
• "Who is this number?"
• "Show me everything from this number"
• "Show conversations from unknown numbers"

CLI Reference

{baseDir}/quo numbers                    List phone numbers
{baseDir}/quo conversations [filters]    List conversations
{baseDir}/quo contacts [--limit N]       List contacts
{baseDir}/quo search-phone <phone> [--refresh]  Find contact by phone (cached)
{baseDir}/quo gather <phone> [--since ISO] [--until ISO] [--limit N] [--refresh]
{baseDir}/quo custom-fields              List contact custom fields
{baseDir}/quo users                      List workspace users
{baseDir}/quo summary <callId>           Get AI call summary
{baseDir}/quo transcript <callId>        Get full dialogue transcript
{baseDir}/quo recordings <callId>        Get recording URLs
{baseDir}/quo voicemails <callId>        Get voicemail + transcript
{baseDir}/quo send --from <num> --to <num> <message>
{baseDir}/quo messages --number-id <id> --participant <phone> [--limit N]
{baseDir}/quo calls --number-id <id> --participant <phone> [--limit N] [--created-after ISO] [--created-before ISO]
{baseDir}/quo raw [METHOD] <endpoint> [json-body]

Conversation Filters

--phone <number-or-id>    Filter by Quo phone line (repeatable)
--updated-after ISO       Conversations updated after date
--updated-before ISO      Conversations updated before date
--created-after ISO       Conversations created after date
--created-before ISO      Conversations created before date
--include-inactive        Include inactive/snoozed conversations
--unknown                 Only show conversations with unrecognized numbers
--limit N                 Max results (default 10)

API Endpoints

Full OpenAPI spec: https://openphone-public-api-prod.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-prod.json

| Endpoint | Method | Description | | ------------------------------ | ------- | -------------------------------------------------------------- | | /v1/phone-numbers | GET | List phone numbers | | /v1/conversations | GET | List conversations (filterable) | | /v1/messages | GET | List messages for a conversation | | /v1/messages | POST | Send a text message | | /v1/messages/{id} | GET | Get message by ID | | /v1/calls | GET | List calls (with date filters) | | /v1/calls/{callId} | GET | Get call by ID | | /v1/call-summaries/{callId} | GET | AI-generated call summary | | /v1/call-transcripts/{id} | GET | Full dialogue transcript with speaker attribution | | /v1/call-recordings/{callId} | GET | Recording URLs (MP3) | | /v1/call-voicemails/{callId} | GET | Voicemail + transcript | | /v1/contacts | GET | List contacts (paginated) | | /v1/contacts | POST | Create a contact | | /v1/contacts/{id} | GET | Get contact by ID | | /v1/contacts/{id} | PATCH | Update contact (replaces entire defaultFields!) | | /v1/contacts/{id} | DELETE | Delete a contact | | /v1/contact-custom-fields | GET | List custom contact fields | | /v1/users | GET | List workspace users | | /v1/webhooks/* | Various | Webhook management for messages, calls, summaries, transcripts |

Key Data Formats

Transcript Response

Returns dialogue[] array with speaker-attributed entries:

{
  "data": {
    "callId": "AC...",
    "dialogue": [
      {
        "content": "Hello",
        "start": 0.16,
        "end": 0.48,
        "identifier": "+15551234567",
        "userId": "US..."
      },
      {
        "content": "Hi, my name is Jane",
        "start": 1.0,
        "end": 2.5,
        "identifier": "+15559876543",
        "userId": null
      }
    ]
  }
}

Contact Fields

• defaultFields: firstName, lastName, company, role, emails[], phoneNumbers[]
• customFields: Array of {key, value} pairs (keys from /contact-custom-fields)
• ⚠️ PATCH replaces entire defaultFields — always include ALL existing fields

Custom Fields (example workspace)

• Property Associated (key: 1712532493777, type: string)
• Address (key: 1700067557182, type: address)

Notes

• Transcripts require call recording enabled in Quo settings
• Phone numbers in E.164 format (+1XXXXXXXXXX)
• Contacts API has no phone number search — search-phone, --unknown, and gather use a local cache at /tmp/quo-contacts-cache.json (5-min TTL, use --refresh to rebuild)
• Voicemail endpoint returns single object (not array)
• gather defaults to last 30 days, text only (no audio URLs or media)