Статьи

Планирование Acuity: встраивание и интеграция с разработчиками

Конечный продукт
Что вы будете создавать

Сегодня я познакомлю вас с платформой разработчика Acuity Scheduling для встроенного бронирования и отдельно с ее API для индивидуальной интеграции. Если вы еще этого не видели, я рекомендую вам прочитать наше основное введение в службу бронирования и назначения календаря Acuity Scheduling из первого эпизода.

Встраивание обеспечивает легкий способ добавления планирования и назначения бронирования на любом веб-сайте. С помощью Appoint Scheduling API от Acuity вы можете интегрировать все его сложные функции календаря в свой собственный веб-сайт, сервис или мобильное приложение.

Acuity Scheduling гордится тем, что является наиболее удобным для разработчиков решением для планирования. Но это также чрезвычайно эффективный веб-сервис для всех ваших задач планирования, бронирования и назначения календаря.

Если вы хотите узнать больше о возможностях планирования, ориентированных на потребителя, посмотрите видео с расписанием ниже:

Поскольку пространство здесь ограничено, я призываю вас зарегистрироваться в Acuity и исследовать больше самостоятельно. Но теперь давайте погрузимся в портал разработчиков Acuity.

Прежде чем я начну, я хочу побудить вас ответить на любые вопросы, которые могут у вас возникнуть о Acuity Scheduling и серии наших руководств. Пожалуйста, оставьте их в комментариях ниже или не стесняйтесь связаться со мной @lookahead_io в Twitter.

Вам не нужно быть программистом или использовать API Acuity для интеграции функций планирования и бронирования по календарю на свой веб-сайт. Есть несколько простых подходов.

Acuity Scheduling Developer Platform - Связь с расписанием встреч

Достаточно просто перейти с вашего веб-сайта или приложения на веб-сайт Acuity. Это приведет клиентов к вашему настроенному интерфейсу планирования на веб-сайте Acuity. Вот один из примеров из первого эпизода :

Acuity Scheduling Developer Platform - Планировщик, ориентированный на потребителя

Документация разработчика Acuity по встраиванию также содержит инструкции по передаче общих полей из вашего приложения в Acuity Scheduler, что экономит время ваших пользователей.

Вот пример URL-адреса, передающего значения Acuity с вашего сайта:

1
2
https://example.acuityscheduling.com/schedule.php?
firstName=First&lastName=Last&phone=Phone&[email protected]

И вы можете отправить различные поля :

Acuity Scheduling Developer Platform - Пользовательские поля для связывания

Если вы настроили пользовательские поля формы приема в Acuity, вы также можете перенести их по ссылке :

1
2
https://example.acuityscheduling.com/schedule.php?
field:1=Wonderful

Они даже поддерживают предварительную настройку выпадающих полей и флажков.

Вы также можете разместить на своем веб-сайте iframe из своей учетной записи Acuity.

Платформа разработчика Acuity Scheduling - встраивание планировщиков iFrame

Код для моей учетной записи выглядит следующим образом:

1
2
<iframe src=»https://app.acuityscheduling.com/schedule.php?owner=132xxxx» width=»100%» height=»800″ frameBorder=»0″></iframe>
<script src=»https://d3gxy7nm8y4yjr.cloudfront.net/js/embed.js» type=»text/javascript»></script>

Они предлагают руководства для общих платформ:

И их разработчики также сделают внедрение для вас, если вы спросите. Для этого у них есть простая веб-форма (она требует, чтобы вы указали свою регистрационную информацию, которую, конечно, вы можете изменить после интеграции):

Acuity Scheduling Developer Platform - Мастер для встраивания справки от Acuity

Вы также можете легко встроить планировщик Acuity в приложения для iOS и Android . HTML-код встраивания Acuity также можно использовать для встраивания планировщика в собственные приложения с помощью WKWebView на iOS или WebView на Android.

Платформа разработчика Acuity Scheduling - iOS и Android легко внедряются

Acuity предоставляет размещенный на GitHub пример кода для встраивания в iOS и Android . По сути, вы просто скачиваете репозиторий и открываете iOSWebviewAcuity в Xcode или AndroidWebviewAcuity в Android Studio.

Теперь поговорим об удобном для разработчиков интерфейсе Acuity для планирования и бронирования.

Acuity Scheduling Developer Platform - Центр планирования для разработчиков

Мы рассмотрели связывание и встраивание клиента в платформу разработчика Acuity , поэтому давайте перейдем к аспекту API планирования .

Если вы хотите расширить возможности своего собственного веб-сайта, службы или мобильного приложения с помощью возможностей Acuity по планированию, календарю и бронированию, вы можете использовать API, чтобы расширить набор функций и услуг, которые вы предлагаете. И вы можете настроить пользовательский интерфейс планирования по своему усмотрению.

Acuity Scheduling Developer Platform - Документация

Я рекомендую начать с документации API планирования (показанной выше) и ее руководств, которые описывают, как использовать его API для распространенных сценариев.

Там также отличный API Quickstart :

Платформа разработчика Acuity Scheduling - API Quick Start

И есть подробное функциональное справочное руководство по API :

Acuity Scheduling Developer Platform - Справочное руководство по API

Acuity предоставляет языковые комплекты разработки для PHP и Node.js.

Каждый содержит общий интерфейс для API и служебных методов, а также множество примеров.

Давайте пройдемся по основам планирования встречи с помощью PHP SDK.

Для начала вам понадобится ваш идентификатор пользователя Acuity и ключ API . Если у вас нет учетной записи, вы можете подписаться на бесплатную пробную версию .

Настройка PHP SDK Acuity очень проста с использованием композитора. Просто запустите команду composer require:

1
$ composer require acuityscheduling/acuityscheduling

Используя ключи API, вы создадите экземпляр библиотеки:

1
2
3
4
5
6
7
8
<?php
 
require(‘./vendor/autoload.php’);
 
$acuity = new AcuityScheduling(array(
  ‘userId’ => YOUR_USER_ID,
  ‘apiKey’ => ‘YOUR_API_KEY’
));

Сегодня я пропущу выборку доступности , но вы можете найти более подробную информацию об этом примере в их учебном пособии « Как назначить встречу с помощью API планирования Acuity» .

Как только у вас появится свободное время, вы сможете назначить встречу. Создание встречи по умолчанию имеет несколько обязательных клиентских полей: firstName , lastName и email . Вам также понадобится appointmentTypeID и доступный интервал времени и datetime .

Если у вашего типа встречи есть какие-либо настраиваемые формы приема, вы также можете установить их, используя атрибут fields .

Вот как вы назначаете встречу, используя библиотеку:

01
02
03
04
05
06
07
08
09
10
11
12
13
14
15
16
$appointment = $acuity->request(‘/appointments’, array(
  ‘method’ => ‘POST’,
  ‘data’ => array(
    ‘firstName’ => ‘Sam’,
    ‘lastName’ => ‘Greenbeans’,
    ’email’ => ‘[email protected]’,
    ‘datetime’ => ‘2016-04-26T19:00:00-0700’,
    ‘appointmentTypeID’ => 5,
    ‘fields’ => array(
      array(
        ‘id’ => 4, // Field ID of my intake form address question
        ‘value’ => ‘1600 Pennsylvania Avenue’
      )
    )
  )
));

Как только в системе появляется новое назначение, бэкэнд-сервисы Acuity управляют важными вещами. Администраторы могут просматривать встречи на внутреннем сервере, отправлять электронные письма с автоматическим подтверждением и выполнять любые интеграции, такие как двусторонняя синхронизация календаря Acuity.

На сегодняшний день мы многое узнали о возможностях Acuity Scheduling в этой серии. Я по-прежнему впечатлен их широтой и глубиной.

До сих пор мы рассматривали интерфейсную службу планирования, ориентированную на потребителя , и сегодня мы рассмотрели встроенное планирование, мобильную интеграцию и введение в дружественный API-интерфейс Acuity для разработчиков. Мы даже показали вам, как запланировать вашу первую встречу.

Завершая этот эпизод, стоит отметить, что, как только в системе появится новое назначение, бэкэнд-сервисы Acuity управляют важными вещами. Администраторы могут просматривать встречу на бэкэнде, а также отправлять автоматические письма с подтверждением и выполнять любые интеграции, такие как двусторонняя синхронизация календаря Acuity.

В следующем эпизоде ​​я опишу некоторые оставшиеся аспекты платформы планирования и бронирования Acuity. Мы коснемся встроенной в Acuity OAuth-интеграции , которая будет полезна, если у вас есть группа людей, зарегистрированных в Acuity, которые используют ваше специальное приложение для операций с календарем. Мы также рассмотрим, как вы можете получить данные обратно из Acuity для создания пользовательских отчетов, добавления их в собственную базу данных или сторонней программы, такой как создание событий Salesforce для встреч, созданных в Acuity. Мы также рассмотрим уведомления webhook, чтобы узнать, когда было выполнено планирование, а также API отчетов.

Пожалуйста, дайте нам знать, какие области вы хотели бы видеть более подробно в следующих эпизодах. Опубликуйте свои идеи и вопросы в комментариях ниже или свяжитесь со мной в Twitter @lookahead_io .

Если вам понравился этот урок, пожалуйста, посетите мою страницу инструктора Envato Tuts +, чтобы увидеть другие мои уроки и серии.