PHPackages zef-dev/convoworks-pckg-appointments - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. zef-dev/convoworks-pckg-appointments ActiveLibrary[Utility & Helpers](/categories/utility) zef-dev/convoworks-pckg-appointments ==================================== Contains conversational workflow elements for managing appointment scheduling scenarios in the Convoworks framework. 1.4.1(1y ago)2119MITPHPPHP ^7.2 Since Jan 11Pushed 1y ago1 watchersCompare [ Source](https://github.com/zef-dev/convoworks-pckg-appointments)[ Packagist](https://packagist.org/packages/zef-dev/convoworks-pckg-appointments)[ Docs](https://github.com/zef-dev/convoworks-pckg-appointments)[ RSS](/packages/zef-dev-convoworks-pckg-appointments/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (10)Dependencies (3)Versions (12)Used By (0) Appointments package for Convoworks =================================== [](#appointments-package-for-convoworks) This package contains conversational workflow elements for managing appointment scheduling scenarios in the [Convoworks framework](https://github.com/zef-dev/convoworks-core). It contains elements that you can use in the conversation workflow, but the appointments data source is just described via the `IAppointmentsContext` interface. When we are talking about workflow components (elements), we have to primarily consider voice and conversational design needs. Their properties, sub-flows and general behavior are tailored to make conversational workflow as easy as possible. They are not related to any particular booking plugin or a similar 3rd party service provider. Appointments context is on the other hand bridge between workflow elements (Convoworks) and the real, concrete appointment system you are using in your system. Appointments context interface ------------------------------ [](#appointments-context-interface) `IAppointmentsContext` describes methods that should be implemented by a target appointments system. If you have e.g. WordPress schedule appointment plugin, you can easily enable it to be used with Convoworks by implementing this interface. Most of the methods require user identification and we use `email` for it. Email works just well with WordPress, while it enables us to have passthrough implementations which do not require the actual user to be created in it. If your target system has several appointment types, the one you need should be configured on this `IAppointmentsContext` type component. To be properly used in the Convoworks GUI, it also has to implement `IBasicServiceComponent` and `IServiceContext`. You might consider to start your implementation like this: ``` class MyCustomAppointmentsContext extends AbstractBasicComponent implements IAppointmentsContext, IServiceContext { } ``` You can check for more about [developing custom packages](https://convoworks.com/docs/developers/develop-custom-packages/) on the Convoworks documentation and you can check our [Convoworks WP Plugin Package Template](https://github.com/zef-dev/convoworks-wp-plugin-package-template) ### `DummyAppointmentsContext` [](#dummyappointmentscontext) Dummy implementation that can serve to test voice applications or as an example when creating your own `IAppointmentsContext` implementation. Here are few predefined features that it has: - business hours are 9:00 - 17:00 on workdays - appointment duration: 30 min - it will store appointments in the Convoworks user scope Workflow elements ----------------- [](#workflow-elements) All appointment package workflow elements have the `context_id` property which hooks them to the context which implements the `IAppointmentsContext` interface. That way elements are concentrated on the conversation workflow needs, while the real business logic is delegated to the concrete implementation. Here are all common parameters: - `context_id` - Id of the referenced `IAppointmentsContext` - `email` - Optional for `CheckAppointmentTimeElement` but required for all others - `timezone_mode` - `DEFAULT` will use default timezone from referenced appointments context, `CLIENT` will try to get client information or `SET` will allow you to explicitly set the value. - `timezone` - only when `timezone_mode` is `SET`. PHP timezone name. Some elements have multiple sub-flows depending on the result we got. This kind of approach enables you to use less `IF` statements in your workflow. But in order not to force you to split workflow, some of the flows are optional and when left empty, the default flow will be executed. ### `CheckAppointmentTimeElement` [](#checkappointmenttimeelement) This element will check if the desired time slot is available. It has several sub-flows, depending on requested slot or suggestions availability. When the requested slot is not available, element exposes suggestions, an array of time slots (timestamps) which could be offered to the end user. Parameters: - `appointment_date` - Optional, requested date in the `Y-m-d` format (the MySQL DATE format) - `appointment_time` - Optional, requested time in the `H:i:s` format (the MySQL TIME format) - `email` - Optional, user identification. If present, it might serve for better suggestions - `return_var` - Default `status`, name of the variable which will be present in sub-flows and that contains information about operation result (`suggestions` : array of suggestions, `requested_time`: requested appointment as timestamp, `requested_timezone`: requested time zone as string, `not_allowed`: `true` when the requested period is out of business hours) Flows: - `available_flow` - Executed when time slot is available - `suggestions_flow` - Executed when the slot is not available an there are suggestions - `single_suggestion_flow` - Optional, executed if there is just a single suggestion. If it is empty (no elements inside), `suggestions_flow` will be executed - `no_suggestions_flow`- Optional, executed if there are no suggestions. If it is empty, `suggestions_flow` will be executed Other: - `suggestions_builder` - Component of type `IFreeSlotQueueFactory` which serves for building suggestions. You can use `DefaultFreeSlotQueue` or create your own. Suggestions representation as JSON. ``` [{ "timestamp" : 123345678, }, { "timestamp" : 123445678, }] ``` ### `CreateAppointmentElement` [](#createappointmentelement) This element will try to create an appointment for a given time slot. It can happen (rarely) that the slot is not free anymore and you can use `not_available` flow to handle it. If a general, unexpected error occurs, the system handler will handle it. Parameters: - `appointment_date` - Requested date in the `Y-m-d` format (the MySQL DATE format) - `appointment_time` - Requested time in the `H:i:s` format (the MySQL TIME format) - `payload` - Various other properties that might be used with an implementing booking plugin. - `return_var` - Default `status`, name of the variable that contains additional information (`appointment_id`: string, `requested_time`: requested appointment as timestamp, `requested_timezone`: requested time zone as string, `not_allowed`: `true` when the requested period is out of business hour) Flows: - `ok` - This flow is executed when appointment is created - `not_available` - Executed when the requested slot is not available ### `UpdateAppointmentElement` [](#updateappointmentelement) Element which updates existing appointment time. Parameters: - `appointment_id` - Id of the existing appointment - `appointment_date` - Requested date in the `Y-m-d` format (MySQL DATE format) - `appointment_time` - Requested time in the `H:i:s` format (MySQL TIME format) - `payload` - Optional, various other properties that might be used with an implementing plugin. When empty, original payload data provided on creation should stay the same. - `return_var` - Default `status`, name of the variable that contains additional information (`existing` previous appointment version as you would get it with load appointment element, `requested_time`: requested appointment as timestamp, `requested_timezone`: requested time zone as string, `not_allowed`: `true` when the requested period is out of business hour) Flows: - `ok` - Executed when the appointment is updated - `not_available` - Executed when the requested slot is not available ### `CancelAppointmentElement` [](#cancelappointmentelement) This element will cancel an existing appointment. Parameters: - `appointment_id` - Id of the existing appointment - `return_var` - Default `status`, name of the variable that contains additional information (`existing`: previous appointment version as you would get it with load appointment element) Flows: - `ok` - Executed when the appointment is canceled ### `LoadAppointmentsElement` [](#loadappointmentselement) This element will load existing appointments for the current user. Parameters: - `mode` : `current` default, `past` or `all` - `limit` : default `10` - `return_var` - Default `status`, name of the variable that contains additional information (`appointments` : array of appointments) Flows: - `multiple` - Executed when the multiple appointments are found. - `single` - Executed when only a single appointment is found. If it is empty, `multiple` flow will be executed. - `empty` - Executed if there are no suggestions. If it is empty, `multiple` flow will be executed ### `LoadAppointmentElement` [](#loadappointmentelement) This element returns single appointment data. Parameters: - `appointment_id` - Id of the existing appointment - `return_var` - Default `status`, name of the variable that contains additional information (`appointment`: array of appointment objects) Flows: - `ok` - Executed when the appointment is loaded. Single appointment representation as JSON. ``` { "appointment_id" : "123", "email" : "user@domain.com", "timestamp" : 123345678, "timezone" : "America/New_York", "payload" : { "some_other_fields" : "That is used by implementing appointment context & WP plugin", "more_fields" : "Some other data" } } ``` Template - Schedule Appointments -------------------------------- [](#template---schedule-appointments) This package is shipped with the ready to use service template - Schedule Appointments. By default it is configured to use our dummy appointments context. You can easily change it on the variables view by changing the `APPOINTMENTS` value. ### Features [](#features) This conversational service enables your users to create, reschedule or cancel appointments. It is designed to provide a nice and rich user experience. Users are able to create new appointments, check if they have existing ones and cancel or reschedule them. When the requested slot is not available, service will suggest several free slots. Other characteristics and requirements: - Ready to use as Alexa skill - Voice only interface - It will require from user to enable access to profile data in Alexa app (name, email) ### Initial setup [](#initial-setup) If you just installed Convoworks WP, you might want to check the [Connect to Amazon and create your first Alexa skill](https://youtu.be/7lx5_ZqazvA) from our [Convoworks basics](https://youtube.com/playlist?list=PL9eUOVS2fICHc7FF48opQyOWUDVvNoNFD) video tutorial series. Open Convoworks WP services view and click on the "Create new" button. Enter your service name, select the "My Booking" template and press the "Submit" button. Now navigate to the service "Configuration" view and select "amazon alexa" configuration button. In the "Amazon Alexa Skill Permissions" section check the "Full Name" and the "Customer Email Address" checkboxes. Press "Save configuration" and your service will be propagated to Alexa Console. You might also change `APP_NAME` in the "Variables'' view. If you plan to use some other appointment context, you should change `APPOINTMENTS` to the appropriate id. Go to the Alexa app (or web app ), click on "Your Skills", select the "Dev skills" tab, find your new skill and enable it. Your Booking skill now can be tested on your Alexa enabled devices. --- For more information, please check out [convoworks.com](https://convoworks.com) ### Health Score 33 — LowBetter than 75% of packages Maintenance48 Moderate activity, may be stable Popularity13 Limited adoption so far Community10 Small or concentrated contributor base Maturity51 Maturing project, gaining track record Bus Factor1 Top contributor holds 78.2% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~131 days Recently: every ~210 days Total 10 Last Release 389d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a22102a6e18bbc5cb744162af11749c2bf1d560e206b7328f5a9e3fbbc07d2ca?d=identicon)[zef-dev](/maintainers/zef-dev) --- Top Contributors [![tolecar](https://avatars.githubusercontent.com/u/2013455?v=4)](https://github.com/tolecar "tolecar (129 commits)")[![mmarcec007](https://avatars.githubusercontent.com/u/10289178?v=4)](https://github.com/mmarcec007 "mmarcec007 (24 commits)")[![Tefached95](https://avatars.githubusercontent.com/u/17346375?v=4)](https://github.com/Tefached95 "Tefached95 (12 commits)") --- Tags convoworks ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/zef-dev-convoworks-pckg-appointments/health.svg) ``` [![Health](https://phpackages.com/badges/zef-dev-convoworks-pckg-appointments/health.svg)](https://phpackages.com/packages/zef-dev-convoworks-pckg-appointments) ``` ### Alternatives [ecotone/ecotone Supporting you in building DDD, CQRS, Event Sourcing applications with ease. 558549.8k17](/packages/ecotone-ecotone)[civicrm/civicrm-core Open source constituent relationship management for non-profits, NGOs and advocacy organizations. 728272.9k17](/packages/civicrm-civicrm-core)[j0k3r/php-readability Automatic article extraction from HTML 186808.8k6](/packages/j0k3r-php-readability)[symfony/ai-platform PHP library for interacting with AI platform provider. 51927.7k134](/packages/symfony-ai-platform)[symfony/ai-agent PHP library for building agentic applications. 30536.7k44](/packages/symfony-ai-agent)[spomky-labs/pwa-bundle Progressive Web App Manifest Generator Bundle for Symfony. 6144.4k1](/packages/spomky-labs-pwa-bundle) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)