Add birdVoiceWebhooksRoute to handle incoming voice call webhooks, support fallback workspace and channel configuration, and send Slack notifications for inbound calls

2026-03-04 10:57:17 +01:00
parent 3d2e8396cc
commit a69df10b77
1 changed files with 42 additions and 0 deletions
@@ -0,0 +1,42 @@
+<?php
+
+namespace routes;
+
+use classes\bird;
+use classes\slack;
+use traits\bird_route_helpers_t;
+use traits\route_t;
+
+class birdVoiceWebhooksRoute
+{
+    use route_t, bird_route_helpers_t;
+
+    public function run(): void
+    {
+        // Handle incoming voice call webhooks from Bird (and any other call webhooks that can be triggered via Bird)
+        $this->post('/bird/voice/calls/webhook/inbound', function () {
+            global $response;
+            // Permission: trigger a voice call via Bird webhooks (intended for incoming call webhooks, but can be used for any call webhooks)
+            self::requirePermission('modules_bird_voice_call_webhooks_trigger');
+            $client = new bird();
+            // Require workspace/channel per Bird API docs
+            $ws = $this->normalizeOptionalString($this->fromRequest('workspaceId') ?? $this->fromQuery('workspaceId'));
+            $ch = $this->normalizeOptionalString($this->fromRequest('channelId') ?? $this->fromQuery('channelId'));
+            if ($ws === '') {
+                $ws = $this->getConfiguredWorkspaceId($client);
+            }
+            if ($ch === '') {
+                $ch = $this->getConfiguredChannelId($client);
+            }
+            if ($ws === '' || $ch === '') {
+                $response->error('Missing required parameters: workspaceId, channelId', 400);
+            }
+            $payload = $this->getParametersAsArray();
+            $slack = new Slack();
+            $slack->send_message('Webhook received for incoming voice call: ' . json_encode($payload), 'Bird Voice Call Webhooks');
+            $response->success($res ?? ['status' => 'ok']);
+        }, [
+            'modules_bird_voice_call_webhooks_trigger' => 'Trigger a voice call via Bird webhooks',
+        ]);
+    }
+}