Third-Party Setup
Step-by-step guides for configuring external services that power Tavio's channels. Complete these setups in the respective provider dashboards, then enter the credentials in Tavio's channel settings.
Meta (Facebook Messenger & Instagram)
- Go to developers.facebook.com and create a Meta Developer account
- Create a new App (select "Business" type) and add the Messenger and/or Instagram products
- Under Messenger Settings, generate a Page Access Token by connecting your Facebook Page
- Set your webhook URL to:
https://bankmind.aihookd.site/api/v1/channels/meta/webhook - Enter a Verify Token (any string you create) and subscribe to the messages webhook field
- Copy the App Secret from App Settings > Basic
- For Instagram: ensure your Instagram Professional account is linked to the Facebook Page, and add the instagram_manage_messages permission
Credentials to enter in Tavio
text
page_id: Your Facebook Page ID
access_token: Page Access Token (long-lived)
app_secret: Meta App Secret
verify_token: Your chosen webhook verify tokenTwilio (Voice & SMS)
- Create an account at twilio.com
- Purchase a phone number with Voice and/or SMS capabilities
- In the phone number settings, set the voice webhook to:
https://bankmind.aihookd.site/api/v1/voice/inbound - Set the status callback URL to:
https://bankmind.aihookd.site/api/v1/voice/status - For SMS, set the messaging webhook to:
https://bankmind.aihookd.site/api/channels/sms - Copy your Account SID and Auth Token from the Twilio Console dashboard
Credentials to enter in Tavio
text
account_sid: Twilio Account SID (starts with AC...)
auth_token: Twilio Auth Token
phone_number: Your Twilio number (+1234567890)Africa's Talking (SMS, USSD)
- Create an account at africastalking.com
- Create an App in the dashboard. Use the sandbox environment for testing
- Go to Settings > API Key and generate an API key
- For SMS: request a shortcode or use the sandbox shortcode for testing
- For USSD: register a USSD service code and set the callback URL to:
https://bankmind.aihookd.site/api/channels/ussd - For SMS callback, set the URL to:
https://bankmind.aihookd.site/api/channels/sms
Credentials to enter in Tavio
text
api_key: Africa's Talking API key
username: AT username (or "sandbox" for testing)
shortcode: SMS shortcode (e.g., 20880)
service_code: USSD code (e.g., *384*123#)ElevenLabs (Voice TTS)
- Create an account at elevenlabs.io
- Go to your Profile > API Keys and generate an API key
- Browse the Voice Library to find a voice that matches your brand. Note the voice_id
- Optionally, clone a custom voice by uploading audio samples in the Voice Lab
Credentials to enter in Tavio
text
api_key: ElevenLabs API key
voice_id: Selected voice ID (optional, uses default if blank)Telegram
- Open Telegram and search for @BotFather
- Send
/newbotand follow the prompts to name your bot - Copy the bot token provided by BotFather
- Create a webhook secret (any random string) for request verification
- Register the webhook using the Telegram API:
Register webhook
bash
curl -X POST "https://api.telegram.org/botYOUR_BOT_TOKEN/setWebhook" \
-H "Content-Type: application/json" \
-d '{
"url": "https://bankmind.aihookd.site/api/v1/channels/telegram/webhook",
"secret_token": "YOUR_WEBHOOK_SECRET"
}'Credentials to enter in Tavio
text
bot_token: Telegram bot token from BotFather
webhook_secret: Your chosen secret for verificationTwitter / X
- Go to the X Developer Portal and create a Project and App
- Apply for at least Basic API access (required for tweet posting)
- Under Keys and Tokens, generate:
- API Key and API Key Secret (Consumer credentials)
- Access Token and Access Token Secret (OAuth 1.0a)
- Bearer Token (for API v2 read access)
- Set your app's User Authentication Settings to include read and write permissions
Credentials to enter in Tavio
text
api_key: X API Key (Consumer Key)
api_secret: X API Secret (Consumer Secret)
access_token: OAuth 1.0a Access Token
access_token_secret: OAuth 1.0a Access Token Secret
bearer_token: Bearer Token for v2 API