Error Codes

The API uses standard HTTP status codes to indicate the success or failure of requests:

To effectively handle errors in your application, we recommend the following practices:

• Check error codes: Always check the error code in the response to understand what went wrong.
• Implement retry logic: For transient errors (like rate limiting or temporary service unavailability), implement retry logic with exponential backoff.
• Log errors: Log errors with their full details for debugging purposes.
• Display user-friendly messages: Translate API error messages into user-friendly messages in your application.
• Monitor error rates: Keep track of error rates to identify potential issues with your integration.

Example Error Handling

async function sendWhatsAppMessage(sessionId, to, text) {
  try {
    const response = await fetch('https://api.messaging.com/v1/messages/text', {
      method: 'POST',
      headers: {
        'Authorization': `Bearer ${API_KEY}`,
        'Content-Type': 'application/json'
      },
      body: JSON.stringify({ sessionId, to, text })
    });
    
    const data = await response.json();
    
    if (!data.success) {
      // Handle specific error codes
      switch (data.error.code) {
        case 'session_not_connected':
          // Prompt user to reconnect
          break;
          
        case 'invalid_phone_number':
          // Show validation error to user
          break;
          
        case 'rate_limit_exceeded':
          const retryAfter = response.headers.get('Retry-After') || 60;
          // Implement retry logic
          setTimeout(() => sendWhatsAppMessage(sessionId, to, text), retryAfter * 1000);
          break;
          
        default:
          // Show generic error to user
      }
      
      return { success: false, error: data.error };
    }
    
    return data;
  } catch (error) {
    return { 
      success: false, 
      error: { 
        code: 'network_error', 
        message: 'Failed to connect to the API' 
      } 
    };
  }
}