Docs/INTEGRATION_GUIDE.md
← All docs
MarkdownHTML Render

Integration Guide

Embed Fantom Interio services and APIs into partner workflows.

Integration Guide

Alexa Skills Kit

Prerequisites

  • AWS account
  • Alexa Developer Console app
  • OAuth provider for account linking

Steps

  1. Create Smart Home skill
  2. Configure account linking OAuth endpoints
  3. Add device discovery and control intents
  4. Deploy Lambda handler for directive routing
  5. Map Fantom Interio adapter responses to Alexa schema

Testing Checklist

  • Discovery returns expected devices
  • On/off and dim commands execute
  • Routine-triggered commands reflect in dashboard

Apple HomeKit / Siri Shortcuts

Prerequisites

  • HomeKit bridge service
  • Accessory metadata mapping

Steps

  1. Register accessories via bridge server
  2. Map Fantom Interio room/device IDs to HomeKit service IDs
  3. Expose Siri Shortcut phrases for scenes
  4. Validate status sync and Siri-triggered actions

Testing Checklist

  • Accessory status parity with Fantom Interio
  • Shortcut-based scene activation works

Google Home

Prerequisites

  • Google Cloud project
  • Smart Home action setup

Steps

  1. Define device traits/types
  2. Configure OAuth and fulfillment endpoint
  3. Implement sync/query/execute handlers
  4. Map actions to Fantom Interio protocol bridge

Testing Checklist

  • Device sync appears in Home app
  • Query state accuracy
  • Execute latency remains acceptable

Samsung SmartThings

Steps

  1. Create Schema connector
  2. Register capabilities and device profile mapping
  3. Implement callback handlers for command/state
  4. Connect Fantom Interio adapter bridge

IFTTT Webhooks

  • Create applets for trigger → webhook action
  • Use signed webhook endpoint proxy
  • Validate idempotency for repeated trigger events