Developers

Extensibility

Build on top of Talkie. Create custom workflows, integrate with external services, and extend functionality through hooks and webhooks.

Integration Points

Talkie is designed to be extended. Whether you want to send transcripts to another app, trigger external services, or build your own automation—there's a way to do it.

Webhooks

POST transcription data to any URL when events occur. Works with Zapier, Make, n8n, or your own services.

Custom Workflows

Create your own automation workflows with triggers, conditions, and actions. Full JSON schema available.

URL Schemes

Deep link into Talkie from other apps, scripts, or Shortcuts. Control recording and access memos.

AppleScript

Full AppleScript dictionary for controlling Talkie programmatically from Alfred, Keyboard Maestro, etc.

Webhooks

Webhooks let you push data to external services when things happen in Talkie. Configure them in Settings → Workflows → Webhooks.

Available Events

  • memo.createdFires when a new memo is saved with transcription
  • memo.updatedFires when a memo is edited or metadata changes
  • workflow.completedFires when a workflow finishes executing
  • dictation.endedFires when a live dictation session ends

Payload Format

Webhook payloads are JSON with a consistent structure:

Webhook Payload Example
{
  "event": "memo.created",
  "timestamp": "2024-01-15T10:30:00Z",
  "data": {
    "id": "abc-123-def",
    "title": "Meeting Notes",
    "transcript": "Today we discussed the Q1 roadmap...",
    "duration": 45.2,
    "language": "en",
    "createdAt": "2024-01-15T10:29:15Z"
  }
}

Webhooks include an X-Talkie-Signature header for verification. Use your webhook secret to validate incoming requests.

Custom Workflows

Beyond the built-in workflows, you can create your own. Workflows are JSON files stored in your Application Support directory.

Workflow Location
~/Library/Application Support/Talkie/Workflows/
Custom Workflow Example
{
  "id": "send-to-notion",
  "name": "Send to Notion",
  "trigger": {
    "type": "keyword",
    "keywords": ["note", "notion"]
  },
  "steps": [
    {
      "type": "transform",
      "prompt": "Format as a clean note with bullet points:"
    },
    {
      "type": "webhook",
      "url": "https://api.notion.com/v1/pages",
      "headers": {
        "Authorization": "Bearer {{secrets.NOTION_TOKEN}}"
      },
      "body": {
        "parent": { "database_id": "{{secrets.NOTION_DB}}" },
        "properties": {
          "title": { "title": [{ "text": { "content": "{{title}}" } }] }
        },
        "children": [{ "paragraph": { "text": "{{result}}" } }]
      }
    }
  ]
}

Share workflows by sharing the JSON file. Import by dropping into the Workflows directory.

Third-Party Integrations

Popular services Talkie users integrate with:

Notion

Send transcriptions to Notion databases via webhook action

Obsidian

Create notes in your vault using the "Save to File" action

Slack

Post summaries to channels via Slack webhooks

Raycast

Quick access via URL schemes and AppleScript

Things / Todoist

Create tasks from voice notes via URL schemes or webhooks

Zapier / Make / n8n

Connect to 1000+ services via workflow automation platforms

PreviousAPI Reference
Back toDocumentation Index