webhook verification token

.env.example

@@ -2,6 +2,8 @@ RINGCENTRAL_CLIENT_ID=
 RINGCENTRAL_CLIENT_SECRET=
 RINGCENTRAL_SERVER_URL=
 RINGCENTRAL_JWT=
+RINGCENTRAL_VERIFICATION_TOKEN=
+
 #The below are only used for the test suite
 RINGCENTRAL_SENDER=
 RINGCENTRAL_RECEIVER=

.github/workflows/run-tests.yml

@@ -60,6 +60,7 @@ jobs:
           RINGCENTRAL_CLIENT_SECRET: ${{ secrets.RINGCENTRAL_CLIENT_SECRET }}
           RINGCENTRAL_SERVER_URL: ${{ secrets.RINGCENTRAL_SERVER_URL }}
           RINGCENTRAL_JWT: ${{ secrets.RINGCENTRAL_JWT }}
+          RINGCENTRAL_VERIFICATION_TOKEN: ${{ secrets.RINGCENTRAL_VERIFICATION_TOKEN }}
           RINGCENTRAL_SENDER: ${{ secrets.RINGCENTRAL_SENDER }}
           RINGCENTRAL_RECEIVER: ${{ secrets.RINGCENTRAL_RECEIVER }}
           RINGCENTRAL_DELAY_REQUEST_SECONDS: ${{ secrets.RINGCENTRAL_DELAY_REQUEST_SECONDS }}

README.md

@@ -32,6 +32,7 @@ RINGCENTRAL_CLIENT_ID=my_client_id
 RINGCENTRAL_CLIENT_SECRET=my_client_secret
 RINGCENTRAL_SERVER_URL=my_server_url
 RINGCENTRAL_JWT=my_jwt
+RINGCENTRAL_VERIFICATION_TOKEN=my_verification_token
 ```
 This package uses the JWT autentication method. You can learn more about setting up JWT for your RingCentral account [here](https://developers.ringcentral.com/guide/authentication/jwt/quick-start).
 

config/ringcentral.php

@@ -14,4 +14,5 @@
     'client_secret' => function_exists('env') ? env('RINGCENTRAL_CLIENT_SECRET', '') : '',
     'server_url' => function_exists('env') ? env('RINGCENTRAL_SERVER_URL', '') : '',
     'jwt' => function_exists('env') ? env('RINGCENTRAL_JWT', '') : '',
+    'verification_token' => function_exists('env') ? env('RINGCENTRAL_VERIFICATION_TOKEN', '') : '',
 ];

src/RingCentral.php

@@ -21,30 +21,32 @@ class RingCentral {
     protected string $clientId;
     protected string $clientSecret;
     protected string $jwt;
+    protected string $verification_token;
     protected string $loggedInExtension;
     protected string $loggedInExtensionId;
 
     public function setClientId(string $clientId): static {
         $this->clientId = $clientId;
-
         return $this;
     }
 
     public function setClientSecret(string $clientSecret): static {
         $this->clientSecret = $clientSecret;
-
         return $this;
     }
 
     public function setServerUrl(string $serverUrl): static {
         $this->serverUrl = $serverUrl;
-
         return $this;
     }
 
     public function setjWT(string $jwt): static {
         $this->jwt = $jwt;
+        return $this;
+    }
 
+    public function setVerificationToken(string $verification_token): static {
+        $this->verification_token = $verification_token;
         return $this;
     }
 
@@ -252,18 +254,16 @@ public function listWebhooks(): Collection {
         return $this->get('/subscription')->collect('records');
     }
 
-    public function createWebhook(array $filters, int $expiresIn, string $address, ?string $verificationToken = null): Response {
+    public function createWebhook(array $filters, int $expiresIn, string $address): Response {
         $data = [
             'eventFilters' => $filters,
             'expiresIn' => $expiresIn,
             'deliveryMode' => [
                 'transportType' => 'WebHook',
                 'address' => $address,
+                'verificationToken' => $this->verification_token,
             ],
         ];
-        if ($verificationToken) {
-            $data['deliveryMode']['verificationToken'] = $verificationToken;
-        }
         return $this->post('/subscription', $data);
     }
 

tests/Feature/RingCentralTest.php

@@ -22,7 +22,8 @@ protected function setUp(): void {
             ->setClientId(env('RINGCENTRAL_CLIENT_ID'))
             ->setClientSecret(env('RINGCENTRAL_CLIENT_SECRET'))
             ->setServerUrl(env('RINGCENTRAL_SERVER_URL'))
-            ->setJwt(env('RINGCENTRAL_JWT'));
+            ->setJwt(env('RINGCENTRAL_JWT'))
+            ->setVerificationToken(env('RINGCENTRAL_VERIFICATION_TOKEN'));
 
         $this->delay();
     }