Intrex Docs
Go to App
← Back to Documentation

Setting up Connectors

Connectors are notification channels that allow Intrex to send alerts via Email, Telegram, WhatsApp, or Webhooks. This guide walks you through configuring each type.

What are Connectors?

Connectors are reusable notification channel configurations. Once set up, you can create multiple notification routes using the same connector to send alerts to different recipients.

Email SMTP
Telegram
WhatsApp
Webhook

Email SMTP

  1. 1Navigate to Settings → Connectors
  2. 2Click "Add Connector" and select Email SMTP
  3. 3Enter SMTP server details (host, port, username, password)
  4. 4Configure encryption (TLS/SSL)
  5. 5Click "Verify" to test the connection
  6. 6Save and create notification routes

Popular Providers

Gmailsmtp.gmail.com:587, Enable "Less Secure Apps" or use App Password
Outlooksmtp.office365.com:587, Modern auth supported
AWS SESemail-smtp.us-east-1.amazonaws.com:587, IAM credentials
SendGridsmtp.sendgrid.net:587, API key as password

Telegram Bot

  1. 1Message @BotFather on Telegram
  2. 2Create new bot with /newbot command
  3. 3Copy the bot token (keep it secret!)
  4. 4Navigate to Settings → Connectors
  5. 5Add Telegram Bot connector and paste token
  6. 6Verify to confirm bot is working
To send to a group, add the bot to the group first, then use the chat ID as recipient.

WhatsApp Business

  1. 1Sign up for WhatsApp Business API via Meta
  2. 2Complete business verification
  3. 3Create a WhatsApp Business account
  4. 4Generate API credentials (Phone Number ID, Business Account ID)
  5. 5Get access token from Meta Developer Console
  6. 6Add connector with credentials and verify
WhatsApp requires approved message templates for business-initiated conversations.

Webhook

  1. 1Navigate to Settings → Connectors
  2. 2Select Webhook connector type
  3. 3Enter your webhook endpoint URL
  4. 4Configure custom headers if needed
  5. 5Set secret for HMAC signature verification
  6. 6Verify endpoint is accessible and returns 200 OK
All webhook payloads are signed with HMAC SHA-256 using your secret.

Testing Connectors

Always verify your connector before using it in production:

1. Create connector with credentials
2. Click "Verify" to test connection
3. Check health status in connector list
4. Create a test notification route
5. Trigger a test event
6. Confirm message received

Troubleshooting

Email: Connection refused

Check firewall rules and ensure SMTP port (587/465) is open. Some providers require TLS enabled.

Telegram: Bot not responding

Verify token is correct. Ensure bot hasn't been blocked. Check if bot needs to be added to group first.

WhatsApp: Invalid credentials

Business verification must be complete. Access token may have expired - generate new one.

Webhook: 403 Forbidden

Ensure webhook endpoint allows POST requests. Check firewall and CORS settings.

Next: Create Notification Routes

Once connectors are set up, create notification routes to define who receives what alerts:

Learn about Routing