Skip to main content

Error Handling & Monitoring

Understand error codes and how the integration handles failures.

Exception Notifications​

When errors occur during integration, alert emails are automatically sent to:

  • RightWave (RW) integration team
  • RDN Support team
  • Email addresses configured in your RDN API Provider metadata

This ensures rapid response to critical issues.

Conditions That Trigger Alerts​

Notifications are sent when:

  • ❌ API is inactive or disabled
  • ❌ Processing Unit (PU) limits are exceeded
  • ❌ Invalid or expired authentication token
  • ❌ Incorrect or missing metadata configuration
  • ❌ Unexpected failure in process execution
  • ❌ API response indicates an error

Error Codes Reference​

CodeExplanationFlow Terminated?Action
Q001, QB01, DB01Unhandled processing exceptionYESCheck RDN logs immediately
Q002, QB02, DB02API endpoint not found (404)NOVerify endpoint in API Provider
Q003, QB03, DB03API error with HTTP statusNOCheck API status page
Q004, QB04, DB04RDN response indicates failureNOReview API response
Q006, QB06, DB06Invalid input field errorNOCheck field mappings
Q007, QB07, DB07Inner exception during processingNOCheck logs for details
Q008, QB08, DB08Retry record save errorNOCheck field permissions
Txx0Trigger change detection errorNOVerify trigger code

Error Code Prefix Guide​

  • Q* = Queueable job errors
  • QB* = Batch job errors
  • DB* = Data flow errors
  • T* = Trigger-related errors

Monitoring Logs​

RDN Platform Logs​

  1. Log in to RDN platform
  2. Navigate to Logs section
  3. Filter by timestamp and integration name
  4. Review error messages and stack traces

Salesforce Debug Logs​

Enable detailed Salesforce logging:

  1. Go to Setup → Developer Console
  2. Click Debug → Change Log Levels
  3. Set Apex Code to FINE
  4. Perform the action you're debugging
  5. View generated logs for details
tip

Debug logs contain detailed information about API calls, field mappings, and processing steps.

Common Error Scenarios​

Scenario 1: Invalid Token Error​

Error Code: Q001 (depends on when detected)

What Happened: Your RDN Auth Token is invalid or expired

Fix:

  1. Go to your RDN API Provider metadata record
  2. Verify the Auth_Token__c value is correct
  3. Request a new token from RightWave if needed
  4. Update the metadata and save
  5. Re-test with a sample record

Scenario 2: API Endpoint Not Found​

Error Code: Q002

What Happened: The endpoint path is incorrect

Fix:

  1. Check RDN API documentation for correct endpoint
  2. Verify endpoint path in RDN API Configuration (e.g., /addScore)
  3. Ensure it matches RDN API specification exactly
  4. Test with RDN API directly using Postman
  5. Update configuration and retry

Scenario 3: Processing Unit Limits Exceeded​

Error Code: Q001

What Happened: You've exceeded RDN API rate limits

Fix:

  1. Check your current usage in RDN dashboard
  2. Wait for quota reset (typically hourly)
  3. Reduce frequency of batch operations
  4. Contact RDN support to increase limits
  5. Retry operations after reset

Scenario 4: Field Mapping Errors​

Error Code: Q006

What Happened: A configured field doesn't exist or can't be accessed

Fix:

  1. Review RDN API Input Field records
  2. Verify Salesforce field names are correct (API names, not labels)
  3. Confirm fields are not marked read-only
  4. Check field-level security permissions
  5. Check for field validation rules blocking updates

Retry Behavior​

Failed API calls follow Salesforce's retry mechanism:

  • Temporary failures (429, 5xx errors) - Automatically retried
  • Retry backoff - Increases exponentially after each attempt
  • Max retries - After 3 retries, job is marked for manual intervention
  • Manual intervention - Check RDN logs for root cause

Retry Example​

Attempt 1: Failed → Wait 5 seconds
Attempt 2: Failed → Wait 10 seconds
Attempt 3: Failed → Wait 20 seconds
Final Status: Manual Review Required

How to Check Error Status​

In RDN Platform​

  1. Log in to RDN
  2. Go to Integration Status
  3. Filter by your Salesforce org
  4. View error details and timestamps

In Salesforce​

  1. Go to Setup → Monitoring → Apex Debug Logs
  2. Filter by recent logs
  3. Search for "error" or "exception"
  4. View log details for each error

Monitoring Dashboard​

Recommended metrics to monitor:

  • Success Rate: % of records processed successfully
  • Error Rate: % of records with errors
  • Processing Time: Average time per record
  • API Latency: Average RDN API response time
  • Failed Records: Count of records needing manual review

Alert Setup​

Email Alerts​

Configure email recipients in RDN API Provider:

  1. Go to RDN API Provider metadata record
  2. Update Get Notified field with email(s)
  3. Use comma-separated format for multiple recipients
  4. Save and verify configuration

Webhook Notifications (Advanced)​

If your org supports webhooks, RDN can send error notifications to:

  • Slack channels
  • Microsoft Teams
  • Custom webhook endpoints

Contact RDN support to set up webhook notifications.

Next Steps​