What gets created
The engine runs the pieces in this order: customer, QuickBooks customer, account, properties. Each property then gets its own follow-up: a map position, a Street View picture and a Major Service Area (the territory). See Draw a service territory.
It runs once
A lead that already has its customer is left alone, whoever converts it or how many times. The engine watches Zoho’s own converted flag on the lead, not the Status picklist: setting Status to Converted by hand does nothing.What the lead shows afterwards
- Zoho fills Converted Contact and Converted Account on the lead. Those are the links to the customer records.
- The engine writes nothing back to a converted lead, and an edit to the lead after conversion goes nowhere: it is not copied to the customer, and it is not pushed to Zoho. Edit the customer, account and property from then on.
A lead born on our side
A phone agent who books a visit in the app for a caller nobody has heard of does not type a lead into Zoho. The app saves the lead on our side, the engine pushes it to Zoho, then asks Zoho to convert it, and the same set-up as above follows. The app waits up to 25 seconds for the customer to be ready before it books the visit. The set-up needs the lead’s Zoho copy. While that copy is not there, the set-up waits and tries again, at growing intervals, up to ten times; it gives up only when the lead’s own push to Zoho has failed for good. If the app times out, it says Couldn’t set the caller up. Check the address, then book again. Booking again keeps the same lead and asks for the set-up again.When the set-up does not happen
Every five minutes the monitor looks for a lead that is converted, or that the app asked to convert, and has had no customer for fifteen minutes. Each one becomes a condition you can act on; what to do with it is on Fix a customer that did not set up properly. The same run does two things about it. It asks Zoho for conversions the engine never heard about, because Zoho sends no conversion event of its own, and replays each one it finds. And it queues the set-up again itself, up to twenty-five leads a run, for every lead that has neither a dead letter nor an open review flag against it. A dead letter is a failed job parked instead of retried; a review flag means a person has to decide before anything runs again. Both are in the Glossary.After the conversion
The customer, the account and the properties are ordinary two-way records. An edit on either side reaches the other, and a change to the customer’s name, email, phone or addresses reaches QuickBooks too. Edit one side at a time: a push writes every shared field, so an edit made on the other side in the same seconds is overwritten. See How sync works.What the engine refuses
- A service address without a street, a city or a postal code. The province and country are worked out; those three are not. The refusal becomes a dead letter and is flagged for review; see Fix a customer that did not set up properly.
- A caller with no email cannot be saved as a lead from the app, because Zoho addresses a lead by its email. The agent fills it in on the call.