Connecting GrabFood to Craveva

Overview

Prerequisites

• Active GrabFood merchant account
• GrabFood Partner API access
• API credentials (Client ID and Client Secret)
• Craveva AI account

Step 1: Request GrabFood API Access

1. Log in to GrabFood Partner Portal
2. Navigate to Settings → API Access
3. Click Request API Access
4. Fill out the API access form:
5. Wait for approval (typically 1-2 business days)
6. Once approved, you'll receive:

• - Business information
• - Use case description
• - Technical contact details
• - Client ID: Your API client identifier
• - Client Secret: Your secret key
• - Merchant ID: Your merchant identifier

Step 2: Generate OAuth Token

1. Use your Client ID and Client Secret to get an access token
2. Make a POST request to https://partner-api.grab.com/oauth2/token
3. Include credentials in request body
4. Save the access token (valid for 1 hour, refresh as needed)

Step 3: Connect GrabFood in Craveva

1. Log in to Craveva AI dashboard
2. Navigate to Data Sources → Connect New Data Source
3. Select REST API connector
4. Choose Delivery Platform category
5. Enter connection details:
6. Click Test Connection
7. If successful, click Save

• - Name: "GrabFood"
• - Base URL: https://partner-api.grab.com/partner/v1
• - Auth Type: OAuth 2.0
• - Client ID: Your GrabFood Client ID
• - Client Secret: Your Client Secret
• - Token URL: https://partner-api.grab.com/oauth2/token
• - Merchant ID: Your merchant identifier

Step 4: Configure Endpoints

• Orders: /orders - Active and completed orders
• Order Details: /orders/{orderId} - Specific order information
• Menu: /menu - Your restaurant menu on GrabFood
• Store Info: /stores/{storeId} - Store information
• Performance: /analytics/performance - Sales and rating metrics
• Promotions: /promotions - Active promotions

Step 5: Create Delivery Management Agents

Order Tracking Agent

1. Create agent to monitor orders
2. Track order status in real-time
3. Alert on delayed orders
4. Monitor average delivery time

Performance Analytics Agent

1. Analyze delivery metrics:
2. Compare performance across time periods
3. Identify peak ordering times

• - Order volume trends
• - Average order value
• - Customer ratings
• - Cancellation rates

Menu Optimization Agent

1. Track popular items
2. Identify slow-moving items
3. Optimize menu pricing
4. Suggest promotions

Available Data

• Orders: All GrabFood orders with status and timing
• Menu Items: Your restaurant menu on GrabFood
• Ratings: Customer ratings and reviews
• Performance Metrics: Sales, ratings, and delivery times
• Promotions: Active and historical promotions
• Store Information: Operating hours and details

Use Cases

Real-Time Order Management

• Monitor incoming orders
• Track order preparation time
• Alert on order delays
• Optimize kitchen workflow

Performance Tracking

• Track daily/weekly/monthly sales
• Monitor customer ratings
• Analyze delivery times
• Compare performance metrics

Menu Optimization

• Identify best-selling items
• Track item popularity trends
• Optimize pricing strategies
• Plan promotional campaigns

Multi-Platform Comparison

• Compare GrabFood with other delivery platforms
• Unified analytics across all channels
• Identify platform-specific trends

Webhook Setup (Optional)

1. In GrabFood Partner Portal → Settings → Webhooks
2. Add webhook URL: https://api.craveva.ai/webhooks/grabfood
3. Subscribe to events:
4. Verify webhook delivery

• - New order
• - Order status update
• - Order cancellation
• - Rating received

Troubleshooting

• Ensure you've completed API access request
• Wait for approval if pending
• Contact GrabFood support if issues persist
• Verify merchant account is active

• Check Client ID and Secret are correct
• Verify OAuth token is valid (refresh if expired)
• Ensure merchant ID matches your account
• Check API access permissions

• Verify your restaurant has active orders
• Check date range filters
• Ensure API has order read permissions
• Wait a few minutes for data sync

• GrabFood API has rate limits
• Implement request throttling
• Cache responses when possible
• Contact support for higher limits if needed

Best Practices

• Token Management: Implement automatic token refresh
• Rate Limiting: Respect API rate limits
• Error Handling: Handle API errors gracefully
• Data Caching: Cache frequently accessed data
• Monitoring: Set up alerts for API failures

Next Steps

• Set up order tracking dashboards
• Create performance analytics reports
• Build menu optimization insights
• Integrate with other delivery platforms for comparison