Setup takes three steps: create API credentials in ServiceTitan, connect them in Invoca, and attach the skill to your agent’s Schedule Appointment action. Invoca recommends setting it up with your Invoca team.
Before you begin
- ServiceTitan is enabled on your Invoca account. If you don’t see it in Manage Integrations, contact Invoca.
- A ServiceTitan admin is available to approve Invoca’s access and create API credentials (a client ID and client secret).
- You know your ServiceTitan tenant ID. Every request the agent makes is tied to this ID. If your company has more than one tenant, decide which one the agent uses.
- You have a booking provider for Invoca. Booking requests are filed under a booking provider in ServiceTitan, so your dispatchers can see where they came from.
- Optional: the campaign, business unit, and job type IDs you want booking requests to carry.
Connect ServiceTitan
You connect by approving Invoca in ServiceTitan and entering the API credentials it gives you. In ServiceTitan (admin):- Approve Invoca’s access to your tenant. Your Invoca team will guide you through this step.
- Copy the client ID and client secret for the connection, and note your tenant ID.
- Open Manage Integrations and select ServiceTitan.
- Add a new credential and enter the client ID and client secret. Invoca checks them when you save.
- Confirm the connection shows as connected.
- Give your Invoca team your tenant ID and booking provider, so the agent sends requests to the right place.
Configure booking details
Your Invoca team sets up these details with you so booking requests land in the right place in ServiceTitan.
Also agree on your booking rules, such as which services the agent may book and how far out, so they can go into your agent’s instructions.
Add the skill to your AI agent
- Open your agent in Agent Builder.
- Open the Schedule Appointment action.
- In the skill field, choose the ServiceTitan skill, then choose your ServiceTitan connection.
- Test the agent against a test customer, then publish it.
How the agent works with ServiceTitan
Before any change, the agent summarizes the customer, location, date, time, and change, and waits for the caller to confirm. It searches for an existing customer before creating one, and gives times in the caller’s timezone.
A booking request isn’t a dispatched job. It appears in ServiceTitan for your dispatchers to review and schedule, and the agent tells the caller your team will confirm. The schedule check shows existing appointments that could conflict, not open technician capacity.
Data and privacy
- No reading back stored data. The agent only confirms details the caller gave, and never shares other customers’ information.
- No made-up results. The agent only reports what ServiceTitan returns. If a save fails, it tells the caller nothing was scheduled.
- No internal details. The agent doesn’t say IDs, error messages, or system terms to the caller.
- You stay in control. To stop access, remove the connection in Manage Integrations, or revoke Invoca’s access in ServiceTitan.
Limitations
- Booking requests, not jobs. The agent can’t create jobs or appointments directly. Your dispatchers schedule each booking request.
- No capacity check. The agent sees existing appointments, not technician availability.
- No cancellations. The agent can’t cancel appointments, jobs, or bookings. Route cancellation requests to your team.
- No new service locations. The agent can update a location but can’t create one.
- One tenant per agent. The agent works in the one tenant you set up.
Troubleshooting
Still stuck? Contact Invoca with the agent name and the time of the conversation.