feat(docs): update authorization docs and change preferred auth (#1652)

Author: oliwiapolec

_redirects

@@ -15,7 +15,7 @@
 /building-apps-for-livechat/* /docs/getting-started/guides/:splat 301
 /build-integration/* /docs/guides/livechat-apps/#building-a-webhook-app/:splat 301
 /how-to-monetize-apps/*   /docs/monetization/how-to-monetize-apps/:splat 301
-/sign-in-with-livechat/*  /docs/getting-started/authorization/sign-in-with-livechat/:splat 301
+/sign-in-with-livechat/*  /docs/authorization/oauth-authorization:splat 301
 /agent-chat-api/* /docs/messaging/agent-chat-api/:splat 301
 /customer-chat-api/*  /docs/messaging/customer-chat-api/:splat 301
 /configuration-api/*  /docs/management/configuration-api/:splat 301
@@ -29,7 +29,7 @@
 /android-widget/* /docs/getting-started/installing-livechat/android-widget/:splat 301
 /ios-widget/* /docs/getting-started/installing-livechat/ios-widget/:splat 301
 /management/configuration-api-v2/*    /docs/management/configuration-api/v2.0/:splat 301
-/getting-started/guides/messaging-apis-in-practice/*    /docs/getting-started/authorization/authorization-in-practice/ 301
+/getting-started/guides/messaging-apis-in-practice/*    /docs/authorization/oauth-authorization/:splat 301
 /extending-ui/extending-agent-app/*    /docs/extending-agent-app/:splat  301
 /extending-ui/extending-chat-widget/*    /docs/extending-chat-widget/:splat  301
 /extending-ui/    /docs/getting-started/#extending-the-livechat-ui 301
@@ -71,7 +71,10 @@
 /getting-started/livechat-apps/* /docs/guides/livechat-apps/:splat 301
 /getting-started/helpdesk-apps/* /docs/guides/helpdesk-apps/:splat 301
 /guides/livechat-apps/webhook-apps/* /docs/guides/livechat-apps/#building-a-webhook-app/:splat 301
-
+/authorization/authorizing-api-calls* /docs/authorization/oauth-authorization/:splat 301
+/authorization/faq* /docs/authorization/troubleshooting:splat 301
+/authorization/sign-in-with-livechat* /docs/authorization/oauth-authorization/:splat 301
+/authorization/authorization-in-practice* /docs/authorization/oauth-authorization/:splat 301
 
 # Redirect images so can work on netlify and /docs domain
 /docs/images/*  /images/:splat  200

src/configs/redoc/customer-accounts-api/spec.yml

@@ -268,7 +268,7 @@ paths:
                   example: c6e4f62e2a2dab12531235b12c5a2a6b
                 code_challenge:
                   type: string
-                  description: Code challenge, as in OAuth2 <a href="https://platform.text.com/docs/authorization/authorizing-api-calls/#pkce-extension">PKCE flow.</a>
+                  description: Code challenge, as in OAuth2 <a href="https://platform.text.com/docs/authorization/oauth-authorization/#pkce-extension">PKCE flow.</a>
                   example: 9_r7xBQQ8RJ3NOr0AMDBqASrf5ZT41PG1qjuLEYDs-c
 
               required:
@@ -312,7 +312,7 @@ components:
     OAuth2 Agent Bearer Token:
       description: >-
         This API uses OAuth2 for agents with the Implicit grant flow. <a
-        href="https://platform.text.com/docs/authorization/authorizing-api-calls/#implicit-grant">Learn
+        href="https://platform.text.com/docs/authorization/oauth-authorization/#implicit-grant">Learn
         about the implicit grant flow.</a>
       type: oauth2
       flows:

src/configs/redoc/customer-accounts-api/specv2.yml

@@ -273,7 +273,7 @@ paths:
                   example: c6e4f62e2a2dab12531235b12c5a2a6b
                 code_challenge:
                   type: string
-                  description: Code challenge, as in OAuth2 <a href="https://platform.text.com/docs/authorization/authorizing-api-calls/#pkce-extension">PKCE flow.</a>
+                  description: Code challenge, as in OAuth2 <a href="https://platform.text.com/docs/authorization/oauth-authorization/#pkce-extension">PKCE flow.</a>
                   example: 9_r7xBQQ8RJ3NOr0AMDBqASrf5ZT41PG1qjuLEYDs-c
 
               required:
@@ -308,7 +308,7 @@ paths:
   /{organization_id}/{group_id}/token/:
     post:
       summary: Create a group token
-      description: Creates a new customer access token for a different group within the same organization. Use this token to separate customer identity across groups within one organization, <a href="https://platform.text.com/docs/authorization/authorizing-api-calls#case-existing-customer-chatting-in-different-groups">click here for more information.</a>
+      description: Creates a new customer access token for a different group within the same organization. Use this token to separate customer identity across groups within one organization, <a href="https://platform.text.com/docs/authorization/oauth-authorization#case-existing-customer-chatting-in-different-groups">click here for more information.</a>
       security:
         - {}
         - Cookie Auth: []
@@ -479,7 +479,7 @@ components:
     OAuth2 Agent Bearer Token:
       description: >-
         This API uses OAuth2 for agents with the Implicit grant flow. <a
-        href="https://platform.text.com/docs/authorization/authorizing-api-calls/#implicit-grant">Learn
+        href="https://platform.text.com/docs/authorization/oauth-authorization/#implicit-grant">Learn
         about the implicit grant flow.</a>
       type: oauth2
       flows: