Review Response Generator v2.0 - Multi-Language AI Replies

Generate professional, personalized review responses with AI and auto-post to Google Business Profile. Supports 9 languages (English, Spanish, French, German, Italian, Portuguese, Chinese, Japanese, Korean) with auto-detect, tone matching, and brand voice preservation.

BYOK (Bring Your Own Key) -- you provide your own API credentials.

---

Before You Start

This actor requires your own API credentials to fetch real data.

Where to get your key: Your OpenAI API key for GPT-4 responses

You can test with Demo Mode first (free, no key needed) to see the output format before committing.

---

Quick Start

Test with Demo Mode (free, no API key needed)

{
  "demoMode": true,
  "reviews": [
    {
      "reviewerName": "John D.",
      "rating": 5,
      "text": "Amazing service! The team was professional and got the job done quickly. Highly recommend!",
      "date": "2024-12-15"
    },
    {
      "reviewerName": "Sarah M.",
      "rating": 2,
      "text": "Waited too long for service. The work was okay but communication could be better.",
      "date": "2024-12-14"
    }
  ],
  "businessName": "Acme Plumbing",
  "ownerName": "Mike",
  "customTemplates": []
}

Run with real data

{
  "demoMode": false,
  "reviews": [
    {
      "reviewerName": "John D.",
      "rating": 5,
      "text": "Amazing service! The team was professional and got the job done quickly. Highly recommend!",
      "date": "2024-12-15"
    },
    {
      "reviewerName": "Sarah M.",
      "rating": 2,
      "text": "Waited too long for service. The work was okay but communication could be better.",
      "date": "2024-12-14"
    }
  ],
  "businessName": "Acme Plumbing",
  "ownerName": "Mike",
  "brandVoice": "professional",
  "responseLength": "medium",
  "includeCallToAction": true,
  "variationsPerReview": 1,
  "openaiApiKey": "YOUR_API_KEY_HERE",
  "responseLanguage": "",
  "autoDetectLanguage": true,
  "useTemplates": false,
  "customTemplates": [],
  "autoPostToGBP": false,
  "gbpAccessToken": "YOUR_API_KEY_HERE"
}

---

Input Parameters

Parameter	Type	Default	Required	Description
reviews	array	-	No	Array of reviews to generate responses for
businessName	string	-	No	Your business name for personalized responses
ownerName	string	-	No	Name to sign off responses with (optional)
brandVoice	string	"professional"	No	Tone and style for responses
responseLength	string	"medium"	No	Preferred length of generated responses
includeCallToAction	boolean	true	No	Add a call-to-action for positive reviews (e.g., 'refer a friend')
customInstructions	string	-	No	Additional instructions for the AI (e.g., 'mention our new loyalty program')
variationsPerReview	integer	1	No	Number of response variations to generate per review (1-3)
openaiApiKey	string	-	Yes*	Your OpenAI API key for GPT-4 responses
responseLanguage	string	""	No	Force responses in a specific language (leave empty to match review language)
autoDetectLanguage	boolean	true	No	Automatically detect review language and respond in the same language
useTemplates	boolean	false	No	Use built-in response templates as a starting point (can be customized with AI)
customTemplates	array	-	No	Add your own response templates (optional)
autoPostToGBP	boolean	false	No	Automatically post the first suggested response to GBP (requires OAuth token)
gbpAccessToken	string	-	Yes*	OAuth access token for Google Business Profile API
gbpAccountId	string	-	No	Your GBP account ID (e.g., accounts/123456789)
gbpLocationId	string	-	No	Your GBP location ID (e.g., locations/987654321)
demoMode	boolean	false	No	Run in demo mode without real credentials. Returns mock success response for testing.
webhookUrl	string	-	No	Optional webhook URL to receive results when response generation completes

*Required when Demo Mode is off.

---

Pricing

This actor uses pay-per-event billing:

Event	Description	Price
Response Generated	Each AI-powered review response generated	$0.05

Demo mode is free -- no charges for sample data.

---

Troubleshooting

"API key is required"

You have Demo Mode turned off but didn't provide an API key. Either:

• Turn Demo Mode on to test with sample data
• Add your API key in the input

"API error 403" or "Unauthorized"

Your API key is invalid, expired, or doesn't have access to this specific API endpoint. Double-check your key and account permissions.

"API error 429" or "Rate limit"

Too many requests. Wait a minute and try again, or reduce the number of items per run.

No results or empty dataset

Check the run log for error messages. Common causes:

• Invalid input format (check the examples above)
• API key without proper permissions
• The target data doesn't exist or is too small to track

How do I test without an API key?

Enable Demo Mode in the input. This returns realistic sample data so you can verify the output format works for your workflow.

---

Built by John Rippy | Actor Arsenal