Integrations

Monitor the operational health of third party integrations with the platform

On the Integrations tab, you can monitor the performance of the third-party integrations. You can also see and analyse the reasons of integration failures.

Integrations Dashboard

Integration Dashboard

Integration Overview

This section displays the overview of all the errors or failed transactions for different integrations types such as Outbound Webhooks, Pre-built Integration, Custom Node, Custom Event, and Inbound Webhooks. The donut chart displays the number of failures or errors for each type of integration. You can click the integration type to show or hide the failure or errors of that integration type in the chart.

Integrations Overview

Integrations Overview

Total Count and Percentage Change

The numbers next to integration and the arrows next to integration counts display the number of failed or successful transactions along with their percentage changes for the integration. The percentage change denotes the increase or decrease in the number of failed or successful transactions with respect to the previous period. For example, if you select to show the data for 1 day, the percentage change is calculated by comparing the data with the previous day.

Percentage Change for Integrations

Percentage Change for Integrations

Counts of Integration Executions and Failures

This section shows the total and failed integration executions for each integration type, along with a comparison to the previous period. For example, the Outbound Webhook was executed 63.04k times in the selected period, with 59.52k failures. Execution of the Outbound Webhook decreased by 64% compared to the previous period, and failures decreased by 63%. For more details on the types of failures, description, and service wise counts please refer to the 'Failures in Integration' section.

The default time frame for viewing the dashboard is the last day, or "Yesterday." You can choose a different period, with a maximum limit of the past 30 days.

Error on Integration

Counts of Integration Executions and Failures

Trends

This section shows the error trends for each integration type for the selected period. By default, the graph is shown for all the integration types with the period as yesterday. You can select individual integration types from the dropdown to see the graph for that integration type or you can click the integration type (Inbound Webhooks, Outbound Webhooks, etc) to show or hide the failure or errors of that integration type in the graph.

Trends for the Integrations

Trends for the Integrations

Failures in Integrations

This section shows the details of the errors that occurred in the integrations at flow and service levels.

Failures in Integrations

Failures in Integrations

Following information is displayed in this section:

NameDescription
Integration TypeType of the integration.
Integration NameName of the integration.
Failure descriptionReason with which the failure has occurred.
ServicesName of the service in which the failure occurred.
FlowsName of the flow in which the service is present.
Total errorsTotal number of errors occurred.
ActionsClick the icon to view the failure details.

When you click the icon under Actions for a failure, the Failure Details screen is displayed with the same information as above. The Failure Details screen lets you directly go to the integration and service in which the failure occurred.

Failure Details for the Integration type

Failure Details for the Integration type

Common Errors for Various Integrations

The following table explains the different scenarios when errors for various integrations occur.

ErrorDescriptionInbound WebhooksOutbound WebhooksCustom NodesPre-built IntegrationsCustom Events
308Permanent RedirectNot applicableThis is a Webex Connect related issue. Please reach out to your account manager or the operations team to resolve the issue.The resolution of the issue depends on the API provider. Please contact the API providers for assistance.The resolution of the issue depends on the API / Prebuilt integration provider. Please contact the API / Prebuilt integration for assistance.Not applicable.
400Bad RequestKindly review your Inbound Webhook request to confirm that the request header, body, and API endpoint are correct. For detailed guidance on making a proper request, please refer to the Inbound Webhook doc.This is a Webex Connect related issue. Please reach out to the account manager or operations team to resolve the issue.Kindly review your custom node configuration to verify that the API endpoint, request header, and body are correct. The resolution will depend on the API provider.Kindly review your Prebuilt node configuration to verify that the API endpoint, request header, and body are correct or reach out to the integration provider for resolution of the issue.Kindly review your Inbound Webhook request to confirm that the request header, body, and API endpoint are correct. For detailed guidance on making a proper request, please refer to the Inbound Webhook doc.
401UnauthorizedThis issue generally occurs when the Service key or JWT is empty or not attached correctly in the Inbound webhook request. For detailed guidance on making a proper request, please refer to the Inbound Webhook doc .The issue occurs If the selected authorization in the Outbound Webhooks is incorrect or expired, you can fix this error by going to the Authorization tab under Assets > Integrations. Choose the appropriate authorization, verify the credentials, and re-authorize it.This issue occurs when the selected Authorization in the Custom Node is incorrect or expired, you can resolve this error by navigating to the Custom Node in Assets > Integrations. Select the required authorization in the custom node, check the credentials, and re-authorize it.If the selected Authorization in the Pre-built Integration is incorrect or expired, it displays as Auth Pending or re-authorize in the status. You can resolve this error by navigating to the Pre-built Integrations in Assets > Integrations. Check the credentials and re-authorize it.If the Service key or JWT auth is empty or not attached, you will see the error. To resolve this error, you must add the authentication as a request body.
403ForbiddenNot applicable.Please reach out to the account manager or operations team to resolve the issue.The error is dependent on the API provider. Generally, this happens if the scope or access is not provided for the API request.The error is dependent on the API provider when the API request's scope or access is not provided.Not applicable.
404Not FoundIf the Inbound webhook is deleted.If the endpoint URL in the Outbound webhook is deleted or does not exist.The error is dependent on the API provider. When a user attempts to access a webpage that does not exist, has been moved, or has a dead or broken link, the response from the API provider can vary.The error is dependent on the API provider. when a user attempts to access a webpage that does not exist, has been moved, or has a dead or broken link, the response from the API provider can vary.If the custom event is deleted.
405Method Not AllowedThe HTTP request protocol is incorrect. Please use HTTP:[POST] protocol.Reach out to account manager or operations team to resolve the issue.The error is dependent on whatever endpoint you configured with respective HTTP method is not allowed by the API provider, please follow the API provider documentation for the proper method (GET/POST/..) and check if the URL configured is correct.The error is dependent on whatever endpoint you configured with respective HTTP method is not allowed by the API provider, please follow the API provider documentation for the proper method (GET/POST/..) and check if the URL configured is correct.The HTTP request protocol is incorrect. Please use HTTP:[POST] protocol.
406Not AcceptableNot applicableNot applicableThe error is dependent on the API provider. This generally happens when the API server is not able to fulfill the request.The error is dependent on API provider. This generally happens when API server is not able to fulfill the request. If your integration is offered by Partner, please reach out to Partner.Not applicable
408Request TimeoutTry increasing the request timeout of the HTTP request. It is configured in the header. Then, try again.Generally, this happens when the endpoint configured is not responding within X seconds.Try increasing the request timeout of the HTTP request. It is configured in the header. Then, try again.The error is dependent on API provider. This generally happens when the API server is not able to fulfill the request. If your integration is offered by Partner, please reach out to Partner.Try increasing the request timeout of the HTTP request. It is configured in the header. Then, try again.
409ConflictNot applicableNot applicableThe error is dependent on API provider, we recommend you retry the request if you receive the error.The resolution of the output depends on API provider. We recommend retrying the request if you receive the error.Not applicable
413Content Too LargeThe error is received when the Payload size is bigger than the payload size that is allowed for your tenant. Please reach out to your account manager or operations team to resolve the issue.The error "Content too large" occurs when the payload size exceeds the allowed limit of the API provider. We recommend you check the API provider documentation for maximum payload size and take appropriate action to reduce the payload.The error is received when the Payload size is bigger than the payload size that is allowed for your tenant.The error is received when the Payload size is bigger than the payload size that is allowed for your tenant.
429Too Many RequestsThe TPS request is greater than TPS allocated for your tenant. To resolve this error, either reach out to account manager to increase the TPS limit or reduce the number of request per second.Reach out to account manager or operations team to resolve the issue.The number of requests that you are sending to the API provider is getting rejected because, the API provider is allowing only limited number of requests per second. To check the exact number of requests refer to the API provider documentation.The number of requests that you are sending to the API provider is getting rejected because, the API provider is allowing only limited number of requests per second. To check the exact number of requests refer to the API provider documentation.The TPS request is greater than TPS allocated for your tenant. To resolve this error, either reach out to account manager to increase the limit or reduce the number of request per second.
500Internal Server ErrorInternal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.The API provider servers is not able to fullfill your request.The error is dependent on API provider. This generally happens when API server is not able to fulfill the request. If your integration is offered by Partner, please reach out to Partner.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.
502Bad GatewayServer is not responding. Please retry after some time.
Reach out to operations team for assistance.
Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.The API end point server is not able to fulfill the request, please check with the API provider.The API end point server is not able to fulfill the request, please check with the API provider. If your integration is offered by Partner, please reach out to PartnerInternal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.
503Service UnavailableInternal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please reach out to API provider.Internal server errors can occur due to server issues. We recommend you to retry. Please reach out to Partner.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.
504Gateway TimeoutInternal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please reach out to API provider.Internal server errors can occur due to server issues. We recommend you to retry. Please reach out to Partner.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.
521Web server is downInternal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.It is a connection time-out error that indicates the website is experiencing a server-side problem. It is a common error that affects Cloudflare-enabled websites. This error occurs when the origin server rejects Cloudflare's connection request. It will not occur for all connection timeout cases. It depends on the provider whether they are giving this status or simply rejecting the request.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.
523Origin is unreachableInternal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server is possible because of the server errors. We recommend you to retry. Please reach out to operations team.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.Internal server errors can occur due to server issues. We recommend that you retry. Please contact the operations team for assistance.
804Problem while processing actionFor the incoming event, the application is unable to process it.Not applicable.Dependent on API provider.Dependent on API provider.For the incoming event, the application is unable to process it.
811Action submission failedFor the incoming event, the application is unable to process it.Not applicable.Dependent on API providerDependent on API providerFor the incoming event, the application is unable to process it.
816User profile not foundFor an incoming event, the corresponding action is not executed because the user profile cannot be found.Not applicable.Dependent on API provider.Dependent on API provider.For an incoming event, the corresponding action is not executed because the user profile cannot be found.
844User has not verified his profileFor an incoming event, the corresponding action is not executed because the user profile cannot be found.Not applicable.Dependent on API provider.Dependent on API provider.For an incoming event, the corresponding action is not executed because the user profile cannot be found.
852Not able to resolve action params to fulfill actionFor the incoming event, the application is unable to process it.Not applicable.Dependent on API provider.Dependent on API provider.For the incoming event, the application is unable to process it.
882TPS rate exceededThe TPS request is greater than TPS allocated for your tenant. To resolve this error, either reach out to account manager to increase the TPS limit or reduce the number of request per second.Not applicable.Dependent on API provider.Dependent on API provider.The TPS request is greater than TPS allocated for your tenant. To resolve this error, either reach out to account manager to increase the TPS limit or reduce the number of request per second.
883TPS quota exceededThe TPS request is greater than TPS allocated for your tenant. To resolve this error, either reach out to account manager to increase the quota or reduce the number of requests.Not applicable.Dependent on API provider.Dependent on API provider.The TPS request is greater than TPS allocated for your tenant. To resolve this error, either reach out to account manager to increase the quota or reduce the number of requests.
884Contact policy not enabledPlease reach out to your account manager to enable the Contact Policy feature.Not applicable.Dependent on API provider.Dependent on API provider.Please reach out to your account manager to enable the Contact Policy feature.