andy/webhook
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 1 Wiki Activity
Files
c1ec1adf85145f055128900a542ec480ebba3487
webhook/parsers/wxinteract.php
T
Andy Dixon c1ec1adf85 Redesign landing page, JSON caller response, shared email shell 
- docs.htm: dark single-page redesign in plain CSS, live URL builder,
  all four parsers documented, Bootstrap CDN dependency dropped
- index.php: respond with pretty-printed JSON (success and 400 error);
  email "Parsed Variables" block uses JSON instead of print_r
- parsers/helpers.php: emailShell() provides one stylesheet, header and
  footer for every email template; five duplicated stylesheets removed
2026-09-11 18:23:25 +01:00

458 lines
18 KiB
PHP
Raw Blame History

<?php
/**
* Webex Interact Webhook Parser
* Parses Webex Interact SMS webhook events into a formatted email
*
* @param string $rawBody The raw request body
* @param array $headers The request headers
* @param array $metadata Request metadata (date, ip, method, contentType)
* @return array|false Array with 'html' and 'subject' keys, or false on failure
*/
function wxinteractParse($rawBody, $headers, $metadata) {
$payload = json_decode($rawBody, true);
if (!$payload || !isset($payload['data'])) {
return false;
}
$data = $payload['data'];
$status = $data['status'] ?? 'Unknown';
// Sanitize common fields
$statusSafe = htmlspecialchars($status, ENT_QUOTES, 'UTF-8');
$dateSafe = htmlspecialchars($metadata['date'], ENT_QUOTES, 'UTF-8');
$ipSafe = htmlspecialchars($metadata['ip'], ENT_QUOTES, 'UTF-8');
// Determine event type and icon
$eventIcon = '📱';
$eventTitle = 'SMS Event';
$eventContent = '';
switch ($status) {
case 'submitted':
$eventIcon = '📤';
$eventTitle = 'Outbound SMS - Submitted';
$eventContent = buildOutboundSmsSubmittedContent($data);
break;
case 'delivered':
$eventIcon = '✅';
$eventTitle = 'Outbound SMS - Delivered';
$eventContent = buildOutboundSmsDeliveredContent($data);
break;
case 'failed':
$eventIcon = '❌';
$eventTitle = 'Outbound SMS - Failed';
$eventContent = buildOutboundSmsFailedContent($data);
break;
case 'shortlink_clicked':
$eventIcon = '🔗';
$eventTitle = 'Shortlink Clicked';
$eventContent = buildShortlinkClickedContent($data);
break;
case 'received':
$eventIcon = '📥';
$eventTitle = 'Inbound SMS Received';
$eventContent = buildInboundSmsContent($data);
break;
case 'opt_out':
$eventIcon = '🚫';
$eventTitle = 'SMS Opt Out Received';
$eventContent = buildOptOutContent($data);
break;
case 'contact_created':
case 'contact_updated':
$eventIcon = '👤';
$eventTitle = 'Contacts Callback';
$eventContent = buildContactsCallbackContent($data);
break;
default:
// Unknown event type - display all data
$eventIcon = '📱';
$eventTitle = "SMS Event: $statusSafe";
$eventContent = '<div class="section"><div class="section-title">Event Details</div>';
$eventContent .= renderDataAsTable($data);
$eventContent .= '</div>';
}
$eventTitleSafe = htmlspecialchars($eventTitle, ENT_QUOTES, 'UTF-8');
$emailTitle = "$eventIcon Webex Interact: $eventTitleSafe";
$emailStamp = "$dateSafe";
$body = <<<HTML
<div class="section">
<div class="section-title">📋 Event Information</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Event Type</div>
<div class="metadata-value">$statusSafe</div>
</div>
<div class="metadata-row">
<div class="metadata-label">IP Address</div>
<div class="metadata-value">$ipSafe</div>
</div>
</div>
</div>
$eventContent
HTML;
$html = emailShell($emailTitle, $emailStamp, $body, "This Webex Interact webhook was automatically forwarded to your email address.");
$subject = "$eventIcon Webex Interact: $eventTitle";
return [
'html' => $html,
'subject' => $subject
];
}
/**
* Build content for Outbound SMS Submitted event
*/
function buildOutboundSmsSubmittedContent($data) {
$messageId = htmlspecialchars($data['message_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$to = htmlspecialchars($data['to'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$from = htmlspecialchars($data['from'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$message = htmlspecialchars($data['message'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$submittedAt = htmlspecialchars($data['submitted_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$campaignId = htmlspecialchars($data['campaign_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
return <<<HTML
<div class="section">
<div class="section-title">📤 SMS Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Message ID</div>
<div class="metadata-value">$messageId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">To</div>
<div class="metadata-value">$to</div>
</div>
<div class="metadata-row">
<div class="metadata-label">From</div>
<div class="metadata-value">$from</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Campaign ID</div>
<div class="metadata-value">$campaignId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Submitted At</div>
<div class="metadata-value">$submittedAt</div>
</div>
</div>
</div>
<div class="section">
<div class="section-title">💬 Message Content</div>
<div class="message-box">$message</div>
</div>
HTML;
}
/**
* Build content for Outbound SMS Delivered event
*/
function buildOutboundSmsDeliveredContent($data) {
$messageId = htmlspecialchars($data['message_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$to = htmlspecialchars($data['to'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$from = htmlspecialchars($data['from'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$deliveredAt = htmlspecialchars($data['delivered_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$campaignId = htmlspecialchars($data['campaign_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
return <<<HTML
<div class="section">
<div class="section-title">✅ Delivery Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Message ID</div>
<div class="metadata-value">$messageId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">To</div>
<div class="metadata-value">$to</div>
</div>
<div class="metadata-row">
<div class="metadata-label">From</div>
<div class="metadata-value">$from</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Campaign ID</div>
<div class="metadata-value">$campaignId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Delivered At</div>
<div class="metadata-value">$deliveredAt</div>
</div>
</div>
</div>
HTML;
}
/**
* Build content for Outbound SMS Failed event
*/
function buildOutboundSmsFailedContent($data) {
$messageId = htmlspecialchars($data['message_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$to = htmlspecialchars($data['to'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$from = htmlspecialchars($data['from'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$failedAt = htmlspecialchars($data['failed_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$errorCode = htmlspecialchars($data['error_code'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$errorMessage = htmlspecialchars($data['error_message'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$campaignId = htmlspecialchars($data['campaign_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
return <<<HTML
<div class="section">
<div class="section-title">❌ Failure Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Message ID</div>
<div class="metadata-value">$messageId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">To</div>
<div class="metadata-value">$to</div>
</div>
<div class="metadata-row">
<div class="metadata-label">From</div>
<div class="metadata-value">$from</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Campaign ID</div>
<div class="metadata-value">$campaignId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Failed At</div>
<div class="metadata-value">$failedAt</div>
</div>
</div>
</div>
<div class="section">
<div class="section-title">⚠️ Error Information</div>
<div class="error-box">
<strong>Error Code:</strong> $errorCode<br>
<strong>Error Message:</strong> $errorMessage
</div>
</div>
HTML;
}
/**
* Build content for Shortlink Clicked event
*/
function buildShortlinkClickedContent($data) {
$shortlink = htmlspecialchars($data['shortlink'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$originalUrl = htmlspecialchars($data['original_url'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$clickedAt = htmlspecialchars($data['clicked_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$phoneNumber = htmlspecialchars($data['phone_number'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$messageId = htmlspecialchars($data['message_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$campaignId = htmlspecialchars($data['campaign_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$userAgent = htmlspecialchars($data['user_agent'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$ipAddress = htmlspecialchars($data['ip_address'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
return <<<HTML
<div class="section">
<div class="section-title">🔗 Click Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Shortlink</div>
<div class="metadata-value"><a href="$shortlink" style="color: #7c3aed;">$shortlink</a></div>
</div>
<div class="metadata-row">
<div class="metadata-label">Original URL</div>
<div class="metadata-value"><a href="$originalUrl" style="color: #7c3aed;">$originalUrl</a></div>
</div>
<div class="metadata-row">
<div class="metadata-label">Phone Number</div>
<div class="metadata-value">$phoneNumber</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Message ID</div>
<div class="metadata-value">$messageId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Campaign ID</div>
<div class="metadata-value">$campaignId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Clicked At</div>
<div class="metadata-value">$clickedAt</div>
</div>
<div class="metadata-row">
<div class="metadata-label">IP Address</div>
<div class="metadata-value">$ipAddress</div>
</div>
</div>
</div>
<div class="section">
<div class="section-title">🌐 Browser Information</div>
<div class="data-box">$userAgent</div>
</div>
HTML;
}
/**
* Build content for Inbound SMS Received event
*/
function buildInboundSmsContent($data) {
$messageId = htmlspecialchars($data['message_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$from = htmlspecialchars($data['from'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$to = htmlspecialchars($data['to'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$message = htmlspecialchars($data['message'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$receivedAt = htmlspecialchars($data['received_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$keyword = htmlspecialchars($data['keyword'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
return <<<HTML
<div class="section">
<div class="section-title">📥 Inbound SMS Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Message ID</div>
<div class="metadata-value">$messageId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">From</div>
<div class="metadata-value">$from</div>
</div>
<div class="metadata-row">
<div class="metadata-label">To</div>
<div class="metadata-value">$to</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Keyword</div>
<div class="metadata-value">$keyword</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Received At</div>
<div class="metadata-value">$receivedAt</div>
</div>
</div>
</div>
<div class="section">
<div class="section-title">💬 Message Content</div>
<div class="message-box">$message</div>
</div>
HTML;
}
/**
* Build content for SMS Opt Out event
*/
function buildOptOutContent($data) {
$phoneNumber = htmlspecialchars($data['phone_number'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$optOutAt = htmlspecialchars($data['opt_out_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$keyword = htmlspecialchars($data['keyword'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$messageId = htmlspecialchars($data['message_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$from = htmlspecialchars($data['from'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
return <<<HTML
<div class="section">
<div class="section-title">🚫 Opt Out Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Phone Number</div>
<div class="metadata-value">$phoneNumber</div>
</div>
<div class="metadata-row">
<div class="metadata-label">From Number</div>
<div class="metadata-value">$from</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Keyword</div>
<div class="metadata-value">$keyword</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Message ID</div>
<div class="metadata-value">$messageId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Opt Out At</div>
<div class="metadata-value">$optOutAt</div>
</div>
</div>
</div>
HTML;
}
/**
* Build content for Contacts Callback event
*/
function buildContactsCallbackContent($data) {
$contactId = htmlspecialchars($data['contact_id'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$phoneNumber = htmlspecialchars($data['phone_number'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$firstName = htmlspecialchars($data['first_name'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$lastName = htmlspecialchars($data['last_name'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$email = htmlspecialchars($data['email'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$status = htmlspecialchars($data['status'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$createdAt = htmlspecialchars($data['created_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$updatedAt = htmlspecialchars($data['updated_at'] ?? 'N/A', ENT_QUOTES, 'UTF-8');
$customFieldsHtml = '';
if (isset($data['custom_fields']) && is_array($data['custom_fields']) && !empty($data['custom_fields'])) {
$customFieldsHtml = '<div class="section"><div class="section-title">🏷️ Custom Fields</div><div class="metadata">';
foreach ($data['custom_fields'] as $key => $value) {
$keySafe = htmlspecialchars($key, ENT_QUOTES, 'UTF-8');
$valueSafe = htmlspecialchars($value, ENT_QUOTES, 'UTF-8');
$customFieldsHtml .= <<<HTML
<div class="metadata-row">
<div class="metadata-label">$keySafe</div>
<div class="metadata-value">$valueSafe</div>
</div>
HTML;
}
$customFieldsHtml .= '</div></div>';
}
return <<<HTML
<div class="section">
<div class="section-title">👤 Contact Details</div>
<div class="metadata">
<div class="metadata-row">
<div class="metadata-label">Contact ID</div>
<div class="metadata-value">$contactId</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Phone Number</div>
<div class="metadata-value">$phoneNumber</div>
</div>
<div class="metadata-row">
<div class="metadata-label">First Name</div>
<div class="metadata-value">$firstName</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Last Name</div>
<div class="metadata-value">$lastName</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Email</div>
<div class="metadata-value">$email</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Status</div>
<div class="metadata-value">$status</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Created At</div>
<div class="metadata-value">$createdAt</div>
</div>
<div class="metadata-row">
<div class="metadata-label">Updated At</div>
<div class="metadata-value">$updatedAt</div>
</div>
</div>
</div>
$customFieldsHtml
HTML;
}
Reference in New Issue View Git Blame Copy Permalink