Skip to main content

Use Siri with SmythOS (Webhook Integration)

Trigger agents with your voice. Connect Apple’s Siri Shortcuts to SmythOS using secure webhook URLs and unlock hands-free workflows on iOS.

TL;DR
Set up a Siri Shortcut that sends an HTTP request to your SmythOS agent's webhook endpoint, and your voice becomes your interface.

Why Use Siri to Activate Your SmythOS Agent?​

Siri is already built into your iPhone, iPad, and Apple Watch... so why not turn it into a control center for your AI agent?

With this integration, you can:

  • Trigger workflows by voice ("Hey Siri, summarise my inbox")
  • Launch tasks without touching a screen
  • Build accessibility-friendly AI assistants
  • Combine native iOS automations with your SmythOS agents

What You Need to Get Started​

  • A deployed SmythOS agent with webhook support
  • Your agent must be publicly accessible (e.g., Deploy via Webhook)
  • iPhone or iPad with iOS 14+
  • The Shortcuts app installed (usually default on iOS)

Step 1: Get Your SmythOS Webhook URL​

  1. Go to your deployed agent in SmythOS
  2. Click Deploy and select Webhook
  3. Copy the generated URL (e.g., https://your-agent.smythos.com/api/v1/chat)
  4. If needed, configure authentication using a Bearer Token or set up Vault access
INFO
You can test this webhook first using Postman - we also have a guide on how - or curl to ensure it responds correctly before adding it to Siri.

Step 2: Set Up Your Siri Shortcut​

  1. Open the Shortcuts app on your iOS device
  2. Tap + to create a new Shortcut
  3. Tap Add Action and search for Get Contents of URL
  4. Select it and configure:
    • Method: POST
    • URL: Paste your webhook URL from SmythOS
    • Request Body: Select JSON and add key-value pairs based on your agent inputs
{
  "prompt": "Summarize the latest updates",
  "user": "siri-user"
}
  1. (Optional) Add a Text action or Show Result to display the response
  2. Name your Shortcut (e.g., "Run SmythOS Agent") and enable Siri by tapping Add to Siri

Step 3: Trigger the Agent with Your Voice​

Once added, just say:

"Hey Siri, Run SmythOS Agent"

…and the webhook will be triggered, sending data to your agent and receiving the response in your shortcut flow.

Handle and Display the Agent Response​

You can enhance the Shortcut by:

  • Showing the response using Show Result
  • Logging it in Notes or Reminders
  • Sending it via iMessage or Email
INFO
Pro tip: Use the response JSON fields to power conditional logic or route data to other iOS apps.

What’s Next?​

Use Siri to trigger your SmythOS agent via webhook and complete tasks using just your voice.