Skip to main content
Your app comes with Convex already integrated. Convex handles all the back-end ops for your health app. You only need to configure any additional third-party services.

​
How Integrations Work

Adding an integration to your Specode app follows this workflow:
1

Tell the AI what integration you want

Describe the integration in your chat. For example:
  • “Add Twilio SMS notifications when appointments are confirmed”
  • “Integrate Stripe to collect copay payments at checkout”
  • “Pull lab results from [Lab API] and display them in the patient dashboard”
2

Ask the AI what credentials you need

Ask: “What API keys do I need to add in Project Settings for this integration to work?”The AI will tell you exactly which keys to get from the external service.
3

Get your API keys

Sign up or log into the external service (Twilio, Stripe, etc.) and copy the credentials the AI specified.
4

Add credentials to Project Settings

Navigate to your project settings (click the project name in the top left corner), scroll to the bottom of the Integrations section, and add your key/value pairs.
5

Tell the AI and verify

Return to the chat and tell the AI you added the credentials: “I added my Twilio keys. Here are the values: [paste keys]. Can you verify the integration works?”The AI will execute or test the integration with your credentials.
The AI guides you through the process. It knows what credentials each service requires and can verify the integration is working once you’ve added them.

​
Pre-configured Integrations

Follow the steps below to add common integrations one-by-one.

​
1. CometChat Video Integration

What it’s for: Powers HIPAA-compliant video appointments between patients and healthcare providers.
1

Contact CometChat

Contact CometChat to set up a HIPAA-compliant subscription for healthcare use. Or create a free account for testing purposes (no PHI!) at cometchat.com.
2

Get API Keys

Once approved, you’ll receive your credentials from the CometChat dashboard (left-side menu > Application > Credentials):
  • App ID → e.g. 1670574c0951d3ac2
  • Region → us (in lowercase)
  • Auth Key → e.g. 2cfa119703d62ed75774da4e33f9f96f85fdf96f
  • Rest API Key → e.g. 393a5593ceb9b9a638524fedad6f54151fc2019c
3

Configure Integration

Add the CometChat credentials to your Specode project settings.
CometChat integration
Press the “Add Field” button a few times and make sure you have 4 empty Key/Value field. Then fill them with CometChat credentials and press Save.
Supabase database URL
Ask AI what exactly you should insert in the corresponding key fields for each of the 4 ComatChat values that you copy from CometChat Credentials dashboard.
HIPAA Compliance Required: Standard CometChat accounts are not HIPAA-compliant. You must specifically request and pay for HIPAA-compliant video calling services before going live with patient video consultations.

​
2. Telegra Integration (Optional)

What it’s for: Provides telehealth and remote monitoring capabilities for healthcare providers.
1

Contact Telegra

Reach out to Telegra for healthcare platform access
2

Get API Keys

Once approved, you’ll receive your credentials:
  • Telegra URL → Telegra_URL
  • API Email → Telegra_API_EMAIL
  • API Password → Telegra_API_PASSWORD
3

Configure Integration

Add all three Telegra credentials to your Specode project settings

​
3. Junction Health Integration (Optional)

What it’s for: Integrates wearable device data and laboratory results for comprehensive patient monitoring.
1

Contact Junction Health

Reach out to Junction Health for healthcare API access
2

Get API Key

Once approved, you’ll receive your credentials:
  • API Key → JUNCTION_API_KEY
3

Configure Integration

Add the Junction Health API key to your Specode project settings

​
5. Stripe Payment Processing

What it’s for: Processes payments for healthcare products, consultations, and subscription services.
1

Create Stripe Account

Go to stripe.com and create a business account
2

Switch to Test Mode

In the Stripe Dashboard, switch to “Test Mode” for development
3

Get API Keys

Navigate to Developers → API Keys and copy:
  • Publishable key → NEXT_PUBLIC_STRIPE_PUBLISHABLE_KEY
  • Secret key → STRIPE_SECRET_KEY
4

Configure Webhooks

In Developers → Webhooks, add endpoint: your-domain/api/webhooks/stripe Copy the signing secret → STRIPE_WEBHOOK_SECRET
5

Add to Project Settings

Add all three Stripe credentials to your Specode project settings

​
Adding Custom Services

Need to integrate with other services? You can add custom environment variables for any additional APIs or services.
1

Navigate to Settings

Go to your project settings in the top left corner of your screen
2

Scroll to Bottom

Scroll down to the bottom of the integrations section
3

Click Add Field

Click the “Add Field” button to create new environment variables
4

Configure Variables

Add your custom service credentials:
  • Variable name (e.g., CUSTOM_API_KEY)
  • Variable value (your actual API key or credential)
Some Custom Integration Examples:
  • Electronic Health Record (EHR) systems
  • Laboratory information systems
  • Pharmacy networks
  • Insurance verification services
  • Custom healthcare APIs
Need Additional Help? If you encounter issues during setup, refer to our Troubleshooting Guide or contact your project team for assistance with HIPAA-compliant service configuration.