Email Integration Setup

Configure automatic ticket creation from support emails

How It Works

✓ Emails sent to your support alias are forwarded to our webhook endpoint

✓ AI automatically analyzes the email content and extracts:

  • • Application (Core, Analytics, Connect, Portal, Mobile)
  • • Priority level (Low, Medium, High, Critical)
  • • Category (Bug, Feature Request, Performance, etc.)
  • • Reporter information

✓ A new ticket is automatically created with all extracted details

Setup Instructions

Use this URL to configure your email forwarding service

Generate a secret key for additional security

Set up email forwarding or webhook integration with your email provider

Gmail (via Zapier/Make)

  1. Create a Zapier/Make automation triggered by emails to your support alias
  2. Add a "Webhook" action with POST method
  3. Set URL to the webhook endpoint above
  4. Map email fields: from_email, from_name, subject, body
  5. Include header: x-webhook-secret with your generated secret

Microsoft Exchange

  1. Use a mail forwarding rule or webhook integration
  2. Forward emails to webhook endpoint with JSON payload
  3. Required fields: from_email, from_name, subject, body

Manual Testing

Test the integration with curl:

curl -X POST https://alphinitisupport.alphinititech.com/api/functions/ingestSupportEmail \
  -H "Content-Type: application/json" \
  
  -d '{
    "from_email": "user@example.com",
    "from_name": "John Doe",
    "subject": "Login issue with SSO",
    "body": "I cannot login to Alphiniti Core..."
  }'
{
  "from_email": "customer@example.com",
  "from_name": "Customer Name",
  "subject": "Issue title",
  "body": "Issue description...",
  "html_body": "(optional) HTML version of email body"
}
Important Notes

• AI analysis happens automatically - support team can review and adjust ticket fields

• Email body is truncated to 2000 characters to ensure reasonable ticket descriptions

• Quoted email text (re: previous messages) is automatically removed

• Each ticket receives an internal comment documenting the email import and AI analysis

• Keep your webhook secret safe if using one - similar to API keys