Released Thursday, January 27, 2022

New REST API End-Point for CEU Credits

A new end-point for CEU information is now exposed in Pathable's REST API. It is now possible to find, create, update and remove CEU Credit information.

Please note: all API calls should respect the Pathable API requests limit of 10 requests / IP / sec.

The basic flow to work with this new end-point:

1. It's necessary to search for the attendee's record (via email for external ID) to get Pathable's internal id to use at the new end-point. This search can be done at either the People or Profile endpoint.
   
   
   1. Via People (Account)
      Sample curl

      --location --request GET 'https://api-us3.pathable.com/v1/people?_email=aa.l@zaansmc.nl' \
      --header 'Accept: application/json' \
      --header 'X-API-KEY: AaAAaAAA000AAAaaa' \
      --header 'Cookie: galaxy-sticky=eGkxcLN5KvmTGtHTy-fmt3g' \
      --data-raw ''

   2. Via Profile (Community)
      Sample curl

       --location -g --request GET 'https://api-us2.pathable.com/v1/people/profiles?searchBy[membership.externalId]=0013s000011zMxtAAE' \
      --header 'X-API-KEY: AaAAaAAA000AAAaaa' \
      --header 'Cookie: galaxy-sticky=eGkxcLN5KvmTGtHTy-fmt3g' \
      --data-raw ''

2. The provider will need to search for the session record (via External ID or Name) to get the session internal ID to use at the new end-point.
   Sample curl

   --location -g --request GET 'https://api-us3.pathable.com/v1/meetings?searchBy[name]=1T001. Opening Session: Rheumatology'\''s Strengths: Science %26 Resilience' \
   --header 'Accept: application/json' \
   --header 'X-API-KEY: AaAAaAAA000AAAaaa' \
   --header 'Cookie: galaxy-sticky=eGkxcLN5KvmTGtHTy-fmt3g' \
   --data-raw ''

3. Use the personId, meetingId, credits, and CEU credits id (CEU credits id is provided after insert it) to insert/update/delete the CEU credits in Pathable's system.

For more details please review the CEU credit information in our API guide. 

NetForum Enterprise Agenda Data Feed Integration

A new agenda data feed has been created between Pathable and NetForum Enterprise. This is a 1-way integration to bring agenda details from NetForum Enterprise to Pathable. 

The data required to connect this feed is: 

• Base URL - Example-: https://yournfesite.org/xweb/secure/netFORUMXML.asmx?WSDL (make sure to include the "?WSDL" parameter at the end of the URL)
  xWeb Username - credentials from NFE API xWeb
  xWeb Password - credentials from NFE API xWeb
• Individual Primary Key - you can keep the default "ind_cst_key"
• Organization Primary Key - you can keep the default "org_cst_key"
• Columns to Events Session object query (Agenda feed) -  indicate the fields that should return on this integration. Initially we recommend: the default "ses_title, ses_start_date, ses_start_time, ses_end_date, ses_end_time", but you can include the ones that are available in your Netforum Enterprise data.
  Event - after including the credentials above you can select the NFE event this integration will use.
• All the other fields can be ignored, as they pertain to the People feed integration. 

Account Cancellation

It is now possible for attendees to delete their account from a Pathable event. On the "Edit my Profile" page, a user can opt to delete their account. After pressing the Delete Account button, the user will be asked to confirm the action by typing their email and selecting Permanently delete account. After doing that the user will be logged out and will not have access to the event or their profile data anymore.

To accommodate international compliance regulations, this cannot be prevented or disabled by Pathable admins. The deleted account cannot be re-added. A new email address will have to be used for a new profile in order to grant the user access to the platform.

Linking to External CEU Credit Claiming 

A button can now be included on agenda items to redirect users to an external CEU credits tool (e.g. AI-Evolution) so they can claim credits there.

This is configured on the admin Dashboard in Settings > Agenda > External CEU Credits Provider

• URL - the provider URL that can contain tokens as parameters, e.g. {personEmail}.
• Security token - this token can be enabled/disabled, and regenerated if needed. The token is sent as a query parameter to the CEU provider. 

Once the URL is configured a new button will appear on the meeting details page for any session with CEU credits configured. The button will only be available after the session has begun.

If CEU data is configured via our REST API  , once the user claims their credit the status will display on the meeting's agenda card. 

This new option must be enabled by a Pathable Administrator- for more information, reach out to your Implementation Specialist. 

Zoom interpretation

This release includes the ability for admins to assign language interpreters on agenda sessions that are enabled as a meeting or webinar. Once a person has been assigned as an interpreter, they will receive an email directly from Zoom with an invitation that contains the meeting details, as well as a join meeting link. It is important that the interpreter use the personalized link emailed to them by zoom to join the session. Joining the session via the Pathable platform will not grant the assigned person the appropriate permission to be an interpreter, they must use the emailed link.

To assign a language interpreter to a session:

1. Create an agenda item and enable it as a meeting or webinar.
2. Select "Enable Zoom Language Interpretation"
3. Select "Add Interpreter", enter an email address, and select the appropriate language
4. Save or Apply changes. Zoom will send an invitation to the email address(es) entered that contains meeting details and a personalized link to the meeting.

This release also includes a number of bug fixes and performance improvements.