Skip to main content
This feature is available only for businesses subscribed to Review Booster.
The Review Booster allows you to send SMS invitations to customers, encouraging them to leave reviews on Google. This feature helps you collect more reviews and improve your online presence by reaching customers directly via text message.

​
Prerequisites

Before using the Review Booster API, ensure you have:
  • Active subscription to Review Booster
  • Valid API key
  • Write access on the business for sending invitations
  • Google My Business Integration: Your business must be connected to a valid Google My Business location
If you need help with any of these prerequisites, please contact your Account Manager who can guide you through the process.
The Review Booster cannot be tested in the Sandbox environment as it requires an active Google My Business connection and a valid subscription.

​
How Review Booster Works

The Review Booster allows you to proactively request reviews from your customers by sending them personalized SMS messages containing a direct link to leave a review on your Google Business Profile.

​
SMS Invitation Flow

  1. Configure sender name: Set up a branded expeditor name that customers will see instead of a phone number
  2. Create or customize template: Use placeholders to personalize your message
  3. Send invitation: The system generates a unique review link and sends the SMS to the customer
  4. Track delivery: Monitor the status of each invitation (created, sent, delivered, or failed)
  5. Customer reviews: Customers click the link in the SMS and are directed to leave a review on Google

​
Anti-Spam Protection

To prevent spamming and maintain compliance with messaging regulations:
  • 10-day cooldown period: A new SMS can only be sent to a specific phone number after 10 days since the last SMS was sent
  • Duplicate detection: Use the search endpoint to check if an invitation was already sent to a customer
  • Force override: You can use the force parameter to bypass the cooldown period when necessary
Overriding the anti-spam protection with the force parameter should be used sparingly to avoid customer complaints and maintain compliance with messaging regulations.

​
Monthly Quotas

Review Booster has monthly sending limits to ensure fair usage and cost management:
  • Default quota: Each business starts with 200 SMS invitations per month
  • Automatic reset: Quotas reset at the beginning of each month based on the business’s timezone
  • Quota tracking: The system tracks remaining invitations and prevents sending when the limit is reached
  • Error handling: When the quota is exhausted, you’ll receive an error: rb_monthly_limit_reached_for_business
  • Custom quotas: Your quota can be adjusted (between 1-1000 per month) by your Account Manager through the admin panel if your business needs differ from the default

​
Implementing Review Booster

Follow these steps to integrate Review Booster into your application:
1

Configure the Sender Name

Before sending invitations, set up a sender name for your business. The sender name must be alphanumeric only, max 11 characters, with one space allowed.
See the Configuring Your Sender Name section below for detailed rules and best practices.
curl -X POST 'https://api.partoo.co/v2/review_booster/expeditor' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "5409c35a97bbc544d8e26737",
    "expeditor_name": "MyBusiness"
  }'
2

Customize Your SMS Template (Optional)

Customize your reusable template that will be used for all future invitations. If you skip this step, a default template will be created automatically when you send your first invitation.
Template placeholders: Use ${client_name}, ${business_name}, and ${url} (required). Max 250 characters excluding placeholders.
See the Working with SMS Templates section below for detailed information about placeholders, constraints, and examples.
curl -X PUT 'https://api.partoo.co/v2/review_booster/template' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "template": "Hello ${client_name}! Thank you for visiting ${business_name}. Share your experience: ${url}"
  }'
3

Check for Duplicate Invitations (Recommended)

Before sending, check if the customer was recently contacted:
curl -X GET 'https://api.partoo.co/v2/review_booster/search-invitation?business_id=5409c35a97bbc544d8e26737&target_phone=%2B33647385968&after=1559148288' \
  -H 'Authorization: Bearer YOUR_API_KEY'
You can find more about the endpoint in the Search Invitations API Reference.
4

Send the Review Invitation

You have two options for SMS content when sending invitations:
  1. Using your template - Uses your saved template (or default if not customized) with placeholders automatically filled
  2. Using custom content - Provide unique invite_content for this specific invitation only
Choose the approach that works best for your use case:
  • Using Template
  • Using Custom Content
curl -X POST 'https://api.partoo.co/v2/review_booster/send_invitation' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "business_id": "5409c35a97bbc544d8e26737",
    "target_phone": "+33647385968",
    "target_name": "John Doe"
  }'
A successful response includes an invitation_id that you can use to track the delivery status.
You can find more about the endpoint in the Send Invitation API Reference.
5

Track Invitation Status

Monitor the delivery status of your invitation:
curl -X GET 'https://api.partoo.co/v2/review_booster/invitation_status?invitation_id=3d90efec-0d7f-4960-98c0-951d58dc14cb' \
  -H 'Authorization: Bearer YOUR_API_KEY'
Each invitation goes through one of these lifecycle states:
  • CREATED: Invitation has been created in the system
  • SENT: SMS has been sent to the mobile carrier
  • DELIVERED: SMS has been successfully delivered to the customer’s device
  • FAILED_SEND: SMS failed to be sent to the carrier
  • FAILED_DELIVERY: SMS was sent but could not be delivered to the customer
The status is updated in real-time via webhooks from the SMS provider. It may take a few seconds for the status to change from SENT to DELIVERED.
You can find more about the endpoint in the Get Invitation Status API Reference.

​
Configuring Your Sender Name

The expeditor name is what customers see as the sender when they receive the SMS instead of a phone number. A well-chosen sender name improves message open rates and trust.
To ensure that SMS messages reach customers correctly and comply with carrier requirements, follow these rules:
  • Do not use first names: Avoid personal names like “Léo”, “Laurence”, “Cédric”
  • Do not use generic names: Avoid generic terms like “Info”, “SMS”, “The Mayor”
  • Use only alphanumeric characters: Letters and numbers only, no special characters or emojis
  • Maximum 11 characters: Keep your sender name concise
  • Only one space allowed: Multiple spaces are not permitted
We recommend using your brand or business name while following these rules. For example: “CafeParisien” or “MyStore”
1

Set the expeditor name for a business

Use the POST endpoint to configure the sender name:
POST /review_booster/expeditor
You can find more about the endpoint in the Set Expeditor Name API Reference.
2

Retrieve the current expeditor name

Get the configured sender name for a business:
GET /review_booster/expeditor?business_id={business_id}
You can find more about the endpoint in the Get Expeditor Name API Reference.

​
Working with SMS Templates

Templates allow you to create reusable, personalized messages for your review invitations. They support dynamic placeholders that are automatically filled when sending invitations.

​
Available Placeholders

You can use the following placeholders in your templates:
  • ${client_name}: The customer’s name (from target_name parameter)
  • ${business_name}: Your business name from Partoo
  • ${url}: The unique review link (required in every template)
The ${url} placeholder is mandatory in every template. Templates without it will be rejected.

​
Template Constraints

  • Maximum 250 characters: Excluding placeholders (placeholders don’t count toward the limit)
  • Must include ${url}: The review link placeholder is required
  • One template per user: Each user has a single template that applies to all their businesses
1

Get your current template

Retrieve your existing template (a default template is created if none exists):
GET /review_booster/template
If no template exists, the system automatically creates a default template for you.
You can find more about the endpoint in the Get Template API Reference.
2

Update your template

Customize your template with your own message:
PUT /review_booster/template
Example template:
Hello ${client_name}, thank you for visiting ${business_name}! 
We'd love your feedback: ${url}
You can find more about the endpoint in the Update Template API Reference.
⌘I