Skip to content

Google Business Profile

Your agents keep your listing current, post updates, and answer every review and question as the business within the hour.

Connect
Sign in once, 1 grant
Runs through
Your account
First run
Read the last 28 days of calls, website clicks and searches, free on your account
Conversation.answer
You, to your agent

Draft the answer to Ray’s five-star review, as the business.

curl -X POST "https://api.sb/leaseline.app/conversations/answer?mode=try" \
  -H "Authorization: Bearer $SB_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"conversation":"conversations/review-ray","body":"Thank you, Ray. Glad the reminders cut your chasing to one text a month."}'
npx startup-builder do Conversation.answer --try --data '{"conversation":"conversations/review-ray","body":"Thank you, Ray. Glad the reminders cut your chasing to one text a month."}'
{
  "name": "do",
  "arguments": {
    "mode": "try",
    "code": "return await $.Conversation.answer({ conversation: 'conversations/review-ray', body: 'Thank you, Ray. Glad the reminders cut your chasing to one text a month.' })"
  }
}
import { $ } from 'startup-builder'

const result = await $.try.Conversation.answer({ conversation: 'conversations/review-ray', body: 'Thank you, Ray. Glad the reminders cut your chasing to one text a month.' })
Response
{
  "$type": "Conversation",
  "mode": "try",
  "stored": false,
  "venue": "google-business-profile",
  "review": {
    "rating": 5,
    "author": "Ray",
    "body": "Set it up in an afternoon. Late rent went from a weekly chore to a monthly one."
  },
  "answer": "Thank you, Ray. Glad the reminders cut your chasing to one text a month.",
  "showsAs": "Response from the owner"
}
Try mode reads, stores nothing and spends nothingAPI referenceIts Nouns

Connect once

  1. Call Integration.connect with system: 'sites-and-content' and venue: 'google-business-profile', then open the connectUrl it returns and sign in as an owner or manager of the profile.
  2. Pick the profile; a new one starts Google’s verification, and your agents post once Google verifies it.
GrantWhat it unlocksScope
Manage your profileHours, categories and links, updates, photos, and answers to reviews and questionshttps://www.googleapis.com/auth/business.manage
ToDo this
PauseIntegration.pause stops every call through Google at once and keeps the token; Integration.resume picks up from the same cursor.
ReconnectIntegration.reconnect returns a fresh connectUrl that lasts one hour, and keeps the Integration's id and cursor, so nothing imports twice.
DisconnectIntegration.revoke revokes the token with Google; every record it brought in stays in your records.

What your agents do

AskVerbRuns throughPrice
Answer each new review as the business.Conversation.answerYour accountFree
Post this week’s update with the new template.Post.publishYour accountFree
How many calls, website clicks and direction requests did the profile get this month, and from which searches?Metric.queryYour accountFree
Change our hours for the holiday week.Integration.callYour accountFree

Calls on your own account are free.

What it holds

NounThe account’s objectWhenWhich side leads
ReviewreviewA customer leaves oneThe account
PostlocalPostYour agent posts an updateYour records
MessagereviewReplyYour agent answers a reviewYour records

Events and webhooks

DirectionEvent
EmitsConversation.answered, Post.published, Review.created
Hears NEW_REVIEWBecomes Review.created

Any Event can wake a Workflow, and a Watch delivers it to your endpoint, signed (Events and webhooks).

Limits

WhatLimitCall
A new profileShows nothing your agents post until Google verifies itPost.publish
Review answersShow publicly under the review, as the business; the agent drafts one within the hour of the reviewConversation.answer

Field map

Our fieldGoogle Business Profile’s fieldCalls
Post.bodylocalPost.summaryPost.publish
Post.linklocalPost.callToAction.urlPost.publish
Post.medialocalPost.mediaPost.publish

What try does here

Returns the update or the answer as it will show on your profile; nothing posts.

How long a connection lasts

A connection lasts until you revoke it in your Google Account; Google also ends a grant left unused for six months, and every call your agents make counts as use.

The platform asks you to reconnect 7 days before it runs out; until you do, a call that needs it refuses with needs-reauth.

Plays and strategies

Used by

No Workflow, agent task or Service acts through it yet: your agents call it directly.

Reference

4 calls, each with its path and price
CallPathPrice
Conversation.answerPOST /conversations/answerFree
Post.publishPOST /posts/publishFree
Metric.queryPOST /metrics/queryFree
Integration.callPOST /integrations/callFree

Contents