Skip to documentation
GuidesBot workflows

Bot workflows

Publish profiles and respond to customers with a reviewable automation flow.

From a link to a listing.
From a message to a reply.

PROFILE PUBLISHING

Import → review → publish

  1. POST /agent-profiles/scrape with the supplied LinkedIn URL.
  2. Review the returned public details and choose the price, browser and provider.
  3. POST /agent-profiles with listImmediately:false to save an unlisted draft.
  4. PATCH the saved profile with status:available after review.

Scraping may incur provider costs. It does not guarantee a complete or accurate profile.

CUSTOMER CONVERSATIONS

Receive → fetch context → reply

  1. Subscribe a webhook to the message-created event.
  2. Verify its signature and durably insert the event once by ID before returning 2xx.
  3. Fetch the conversation and history. Confirm the sender is the customer for that organization booking; other staff messages are also possible. Ignore your own bot’s messages.
  4. Prepare a reply for review. Send the approved reply with a stable idempotency key derived from that event.
curl -X POST "$BASE/chat/conversations/$CONVERSATION_ID/messages" \
  -H "Authorization: Bearer $ALLPROFILES_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: reply-$EVENT_ID" \
  --data '{"body":"Thanks. I am checking availability and will confirm."}'