GoHighLevel voice AI integration

Find an existing GoHighLevel contact by phone number. Use this to recognise a caller before creating a duplicate, and to get the contact_id that booking, tasks, notes and opportunities all need.

Inputs

Fetch one GoHighLevel contact by its ID. Use after a lookup when you need fields the search did not return, such as the properly-capitalised name, address or custom fields.

Inputs

Create a GoHighLevel contact for the caller, or match an existing one on the same phone or email. Safe to call for a repeat caller: it will not create a second record.

Inputs

Update fields on an existing GoHighLevel contact. Only the fields you supply are changed. Use when a caller corrects their details. Always supply at least one field besides the ID — calling this with only the ID changes nothing, and reports success anyway.

Inputs

Add one or more tags to a GoHighLevel contact. Tags are how GoHighLevel workflows are triggered, so use the exact tag names the business asked for.

Inputs

List the opportunities (deals) attached to a GoHighLevel contact, newest first. Use to tell a caller where their enquiry currently stands.

Inputs

Fetch one GoHighLevel opportunity by its ID, including its pipeline, stage, status and value.

Inputs

Create a GoHighLevel opportunity (deal) for a contact in the pipeline this tool is pointed at. Use when a caller expresses real buying intent.

Inputs

Update a GoHighLevel opportunity — change its name, value, status, or move it to another stage. Only the fields you supply are changed. Always supply at least one field besides the ID — calling this with only the ID changes nothing, and reports success anyway.

Inputs

List the tasks on a GoHighLevel contact. Returns completed tasks as well, so check the completed flag before telling a caller something is still outstanding.

Inputs

Create a follow-up task on a GoHighLevel contact. A due date is required — if the caller did not name one, use tomorrow morning in their local time.

Inputs

Write a note onto a GoHighLevel contact — what the caller asked for, what was agreed, anything the next person needs. Keep it to a short paragraph.

Inputs

List the appointments booked for a GoHighLevel contact. This returns their whole history including past and cancelled ones, so read appointmentStatus and pick the upcoming one before answering the caller.

Inputs

Find free appointment slots on the calendar this tool is pointed at, between two dates. Offer the caller two or three of the returned times; each one can be passed straight to Book an appointment exactly as returned.

Inputs

Book an appointment for a contact on the calendar this tool is pointed at. You must have a contact_id first — look the caller up or create them. Use a start time exactly as returned by Check appointment availability.

Inputs

Fetch one GoHighLevel appointment by its event ID — its time, status and which calendar it is on.

Inputs

Move an existing GoHighLevel appointment to a new time. Check availability first and pass a returned slot through unchanged — GoHighLevel refuses a time that is not actually free.

Inputs

Cancel a GoHighLevel appointment. The booking stays on the record marked cancelled, the slot is freed, and the sub-account's cancellation workflows run.

Inputs