Ripcord.io Technical Installation

To install the Ripcord booking widget on your website please follow the following instructions. The ripcord booking widget will pass through all UTM url parameters to track lead to demo conversion source from the page the script is being ran from.


Import via CDN

Add this code snippet to the main page your website to start routing leads. Make sure to replace the el  property with the CSS selector of the button that should open the Ripcord widget.

<script src="https://cdn.jsdelivr.net/npm/@ripcord.io/meeting@2"></script>
<script>
  const instance = new ripcord.Widget({el: "#open-widget-button", routingId: "CHANGETOYOURID"})
</script>

You can also use an HTMLElement  instead of a CSS selector:

<script src="https://cdn.jsdelivr.net/npm/@ripcord.io/meeting@2"></script>
<script>
  const button = document.getElementById("open-widget-button")
  const instance = new ripcord.Widget({el: button, routingId: "CHANGETOYOURID"})
</script>

Lastly, you can programmatically open the Ripcord widget by calling the open  method on the Widget  instance:

<script src="https://cdn.jsdelivr.net/npm/@ripcord.io/meeting@2"></script>
<script>
  const button = document.getElementById("open-widget-button")

  const instance = new ripcord.Widget({routingId: "CHANGETOYOURID"})

  button.addEventListener("click", () => {
    instance.open()
  })
</script>
Render inline

You can also embed the booking form directly on your page by using the Inline  constructor:

<script src="https://cdn.jsdelivr.net/npm/@ripcord.io/meeting@2"></script>
<script>
  const container = document.getElementById("booking-widget-container")

  const instance = new ripcord.Inline({el: container, routingId: "CHANGETOYOURID"})

  instance.initialize()
</script>
Booking Endpoint

Use this endpoint to book meetings directly from Facebook, Zapier, etc.

Overview

This documentation describes how to use our public booking endpoint for integrations with platforms like Facebook, Zapier, and other third-party services. This endpoint allows you to create bookings by submitting client information, preferred day of the week, and time preferences.

Endpoint Details
URL:

https://api.ripcord.io/public/routing/CHANGEYOURID/book

Method:

POST

Response:

HTTP 204 (No Content)


Parameters

name string

Client's full name


email string

Client's email address


phone string

Client's phone number


url string

Client's website or relevant URL

* Optional


day string

Preferred day of the week. Accepted values (case-insensitive):

monday tuesday wednesday thursday friday saturday sunday

timeframe string

Preferred time of day. Accepted values (case-insensitive):

morning afternoon evening
Important Notes
  • This endpoint guarantees that a meeting will be booked.
  • If your routing configuration leads to a Recorded Demo, the system will select a user at random from the entire account.
  • We recommend avoiding Recorded Demo as an outcome option for routings intended for use with this endpoint.


CURL Example

curl -X POST 'https://api.ripcord.io/public/routing/CHANGETOYOURID/book' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Jane Smith",
    "email": "jane.smith@example.com",
    "phone": "555-123-4567",
    "url": "https://example.com/profile",
    "day": "tuesday",
    "timeframe": "afternoon"
  }'

Javascript Example

fetch('https://api.ripcord.io/public/routing/CHANGETOYOURID/book', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    "name": "Jane Smith",
    "email": "jane.smith@example.com",
    "phone": "555-123-4567",
    "url": "https://example.com/profile",
    "day": "tuesday",
    "timeframe": "afternoon"
  })
})

Still need help? Contact Us Contact Us