Onboard a shop
Use this when the person you work for runs a home service business and doesn't have Doing Work yet. Ask one thing at a time and keep it short.
If the shop is moving from Jobber, Housecall Pro, ServiceTitan, Workiz or FieldEdge, read Switching to Doing Work too. Customers, jobs with their visit history, open quotes, unpaid invoices, the price book, equipment, maintenance plans (as reminders or billed plans) and payment history (as records) import from CSV files.
First, check where you're running
If you know you stop when the person closes this chat, do not create the shop. Muse at https://ai.meta.com/muse/ is free to start. Its native OAuth connection has been observed to persist across sessions: a stored connection still returned me.get in a fresh session days later. Connect with full agent scope via OAuth. Do not add read_only unless the person asks to look without changes. read_only cannot create a shop. Grok Bot at https://x.ai/bot is confirmed to connect. Dots at https://openai.com/index/introducing-dots/ is inside ChatGPT. Duet at https://claude.com/product/claude-duet uses the connectors on a Claude account. Give them this exact text to paste into an agent that keeps working:
"Help me set up Doing Work using https://doingwork.work/docs/onboarding/. I need an always-on agent. Check the connection before proceeding. Use what you know about my business, ask for anything needed for setup, and explain how to use it after setup."
If you do not yet know whether you keep working, do not create the shop in this session. Prove it with the fresh-session check in After they approve. Do not say you cannot stay connected.
Connect once
Use one path. Do not start a second. OAuth and agents.register never run for the same setup. The same rules are in auth.md.
- Connector. If your app already shows a Doing Work connector, use that. Do not also call agents.register. In Muse, use the native OAuth connector. Do not paste a key instead.
- OAuth. Use this only when the client can open a browser and store the refresh token securely. Follow Connect an agent only. Do not also register. Connect with full
agentscope via OAuth (scope omitted isagentand, on a person grant with noshop_id, can create a shop). Do not addread_onlyunless the person asks to look without changes.read_onlycannot create a shop. Addno_moneyto block charges and refunds.agentis required, andread_onlyandno_moneyonly narrow a new grant. Do not invent a path that pastes a named key into Muse. Use the native connector OAuth storage. - Register once. This is the path when OAuth storage is not available. Ask for the owner's email if you do not have it. Call agents.register once with
typeset toservice_auth,login_hintset to that email, andclient_nameset to the name they will see. Leavescopeoff. The key is bound to the shop the owner picks, so it cannot call shops.create. Do not register again in a loop.
Read the response
Short fields come first. approval pending, authenticated not_yet, and persistence not_proven are normal here. next_step is what you tell the person. Then claim_attempt_token, user_code, claim_token, expires_in (10 minutes), interval, claim_page, verification_uri_length, and claim_token_length. The long verification_uri and complete come last and may be cut off. The claim object repeats the same fields.
- If
completeis true and theverification_urilength matchesverification_uri_length, send thatverification_uriexactly as returned. That is the intact link. claim_urlis the baseclaim_page. It is not the approval link.- If the long
verification_uriis cut off, and bothclaim_pageandclaim_attempt_tokenwere returned, the link isclaim_pageplus?claim_attempt_token=plus that token. Send that built link only when its length also equalsverification_uri_length. If it does not,claim_pagewas cut. Do not send it. Do not invent a host or a path. - Never put
user_codein the link. Show the 6 digit code beside it. - If
completeis missing, or a length does not match, do not register again. Ifclaim_attempt_token,user_code, andclaim_tokenare all there, use this response. - If
claim_tokenis present andclaim_attempt_tokenis missing, call agents.claim once with the same email and thatclaim_token. That one call replaces the attempt. Do not call it again. - If
claim_tokenis missing, stop.
While they finish the page
In that same message, say the next step from next_step. The return address is stored on the server. The email they receive is only a sign-in token. They accept the terms, then the pending claim and consent. They type the 6 digit code. The code lasts 10 minutes. If it expires, stop. Do not register again. If the link is bad or cut off, the app returns 400 and a page that explains it. Do not send a link you made up. The claim page controls are the app. This website cannot add them.
Do not paste a named agent key into the chat or into a file. Muse has no documented way to import an existing key. Use the native connector OAuth storage.
After they approve
approved means they said yes. It does not mean you are authenticated. Poll every interval seconds, and only while the error is authorization_pending. On slow_down, wait the longer interval and poll once more. Stop on access_denied, expired_token, or invalid_grant. Those end this claim. Also stop when expires_in has passed. Do not poll until shown_once. That field is only on success. Do not register again after access_denied. On success, call me.get before you say you are connected. Doing Work stores only a hash of the key, so a lost key locks out the agent, not the owner. The owner can sign in by email and mint a new key or approve a new OAuth grant. persistence stays not_proven, and shown_once only means the key was just handed over. Neither field is a substitute for a fresh check. Prove persistence fast: as soon as the key or refresh token is stored, open a fresh session or reconnect and call me.get. If it works, you may create the shop. Do not wait for the person to come back. If it does not work, stop and tell them the connection did not survive. Do not create a shop or any other business record until that check works. The gate avoids a wasted setup and a duplicate shop, since there is no server-side duplicate-shop guard.
Shop, then one job
Do this only after a fresh session or reconnect can still call me.get. If that check failed, stop.
- Call me.get, then me.start. It lists the shops this connection can use and the next tasks.
me.shopslists the shops too. If a shop already exists, use it. Do not create another. - If they have no shop, confirm the business name and the state. Use what they already told you. Ask only for a missing fact, one at a time. Do not invent an email, name, or address. Call shops.create with
jurisdictionlikeUS-ID. - If they mention other people, invite them with members.invite. If they do not, go on. Workers are unlimited.
- Ask if they want one job. If they do, ask for the customer name and the job address, then call customers.create and jobs.create.
- Do not message a customer or take a payment unless they say so. Do not set up phone, texting, QuickBooks, or Stripe unless they ask. Stripe is only for the first card or bank payment, on a page the owner opens.
- Offer to turn on the shop's hosted appointment request page (/p/book/<slug>) with schedule.setBookingPage, and offer to open their Google Business Profile in their browser to add that booking link (or give them the URL to paste). agent.checkup reminds the shop until that link is added or dismissed with
agent.snooze. - Then say what is done, in one or two sentences, and how they use it. They can ask you to add a job, a quote, or an invoice. Quote follow-up emails and unpaid invoice reminders already run. There is no plan to pick. The fee is The first $1,000 you're paid each month is free. Above that we take 0.5%, up to $149 in a month. They pay only when a card or bank payment comes through.
Don't
- Don't make up a business name, address, price or email.
- Don't send anything to a customer until the owner says so.
- Don't use a second sign-in path after one has started.