Pigeonhole

Lineup Ninja can create Q&A’s for your sessions in Pigeonhole.

Create the integration

   In Lineup Ninja, navigate to Agenda Planning  > Publish Agenda  then click the ‘Integrate’ button under ‘Pigeonhole’. This will create a new integration.

A dialog will be displayed, compete the requested fields:

API Key

In the Pigeonhole interface:

• Click the dropdown in the top left and choose ‘Workspace Settings’ for the workspace you want to integrate.
• Click ‘Developer’.
• Tick ‘Enable API Access’ if it is not already selected.
• Click ‘Copy’ for the API Key and paste that into the API Key field in Lineup Ninja.

Pigeonhole Id

Browse to your event in Pigeonhole and click ‘Event Info’. Click the address bar in your browsers and you will find an address like this: https://dashboard.pigeonholelive.com/p/1234/about. Copy the number between /p/ and /about and paste that into the Pigeonhole Id field in Lineup Ninja.

Type of session to create in Pigeonhole

Choose the type of session to create in Pigeonhole. One session of this type will be created for each session you publish to Pigeonhole.

Moderator Role

In Pigeonhole speakers can be added as either a ‘Speaker’ or a ‘Moderator’. If you have a corresponding ‘Moderator’ role in Lineup Ninja then choose the role here.

Prefix for Session Custom Fields

When you create a session in Pigeonhole these URLs are available for the session:

• Audience WebApp
• Projector Panel
• Admin Panel
• Moderator Panel

The integration will create Custom Fields for these so you can see the detail for each session in Lineup Ninja.

By default these will be called Pigeonhole Audience WebApp, Pigeonhole Projector Panel etc… If you have multiple Pigeonhole integrations you can change the ‘Prefix’ so that, for example, one set of fields would be called Q&A Audience WebApp and the other Poll Audience WebApp.

Publishing your schedule

To publish your schedule just click the ‘Publish’ button!

You may be asked if you wish to publish a ‘Full’ schedule or a ‘Changes Only’ update. A Full update will publish all speakers and sessions regardless of whether they have been updated in Lineup Ninja since you last published. A ‘Changes Only’ update only publishes speakers and sessions that have changed which will be quicker.

Please note that sessions that have a Start Date in the past cannot be updated and any changes will be skipped.

How can I filter the published content?

You can filter which Speakers and Sessions will be published based on a number of criteria. Some common use cases for filters are:

• Preventing ‘Placeholder’ sessions from being published
• Holding back a Speaker who is not yet ready to be announced
• Excluding sessions scheduled during the ‘build up’ day for the event
• Only publishing speakers who have confirmed their slot
• Removing a particular location, or track from the published schedule
• Anything you can think of using labels!

For Speakers you can filter in 3 ways

• Choose which speakers are to be published based on their relationship to sessions
  • (If Speaker Confirmation is enabled): Publish speakers that have a confirmed session that is published and not filtered out.
  • Publish speakers that are speaking on any session that is published and not filtered out.
  • Publish all speakers
  • Publish no speakers
• Apply more granular filters with labels
  • Only publish speakers with a particular label. For example you might want to use a ‘Content Reviewed’ label to flag speakers that have had their content reviewed.
  • Exclude speakers with a particular label. For example you might want to exclude a ‘Do not publish’ label to prevent publishing of speakers who are not yet ready to be published.

For Sessions you can filter in numerous ways

• Choose which sessions are to be published based on their relationship to speakers
  • Publish All Scheduled Sessions. Publishes sessions regardless of whether they have confirmed speakers or not.
  • (If Speaker Confirmation is enabled): Publish sessions that have one confirmed speaker.
  • (If Speaker Confirmation is enabled): Publish sessions that have all their speakers confirmed.
  • Publish All Sessions (available on Lineup Ninja Agenda App only)
• Apply filters with labels
  • Only publish sessions with a particular label. For example you might want to use a ‘Content Reviewed’ label to flag sessions that have had their content reviewed.
  • Exclude session with a particular label. For example you might want to exclude a ‘Placeholder’ label to prevent publishing of sessions which are not yet populated.
• Filter by location
  • Only publish sessions in a particular location, or locations. This can be useful if you are publishing an agenda for just one or two locations.
  • Exclude sessions in a particular location, or locations. This can be useful if you have scheduled sessions in your Green Room or similar back stage location.
• Filter by resource
  • Only publish sessions needing a particular resource. This could be useful if you are producing an agenda for a particular team that manages some resources.
  • Exclude sessions needing a particular resource.
• Filter by Date
  • Only publish sessions in a date or dates. Useful if you are producing an agenda for a particular day.
  • You can exclude a date or dates from your publication. Useful if you have dates for build up and tear down in your agenda.
• Filter by Track
  • Only publish sessions in a particular track or tracks. Useful if you are producing separate agenda for separate parts of your event
  • Exclude sessions on a particular track. Can be useful to block presenting of a track until a product launch has happened.

To configure filters:

• Click ‘Publish Agenda’
• Click on the name for your existing publication
• Click ‘Configure’
• Expand the ‘Filter Speakers’ and ‘Filter Sessions’ sections and configure the filters you need
• Save and republish

How can I embargo content that is not yet ready for the public?

You can choose to embargo session titles and descriptions if you have content that should only be shown to the public after being announced in the event.

An embargo is applied by using labels to identify the sessions that should have an embargoed session title or description.

For example if you have a label ‘New Product Launch’, you can configure an embargo to hide the session title and description from sessions with that label. Following the launch of the product you can remove the embargo and republish the agenda.

If you embargo a session or description you can replace the original text with something to indicate that the session will be published later, for example ‘Super Secret Session’.

The speakers for a session will still be shown when it is embargo’ed. To exclude a session, including it’s speakers from being published then use ‘Session Filters’ rather than an ‘Embargo Content’.

To configure an embargo:

• Click ‘Publish Agenda’
• Click on the name for your existing publication
• Click ‘Configure’
• Expand the ‘Embargo Content’ sections and configure the embargo that you need
• Save and republish

How can I merge locations when publishing?

When publishing you can merge content together. This enables you to publish a simpler agenda for your attendees than the one you are using to plan your event. You can choose to merge these types of data: * Locations. Merging location A into location B will show all sessions in location A as taking place in location B. This can be useful if you have multiple locations configured for scheduling purposes that will be experienced by the attendee as a single location. When merging the location that you are merging into does not have to have any sessions itself. So you can use this to show a different name to attendees than you are using internally. For example you could create a 'Main Hall' location, and merge 'Building B - Hall A' into that location so attendees see 'Main Hall' in their agenda.

How are Titles handled?

By default titles are published in Pigeonhole as the speakers title. There is a defined set of permitted titles in Pigeonhole, if the speakers’s title is not one of these options it will be ignored. You can find the list of allowed titles in the salutation part of this page. If you don’t want to publish titles configure ‘Should Titles be Published’ in ‘Titles, Post Nominals, Position and Company’

Please note that once a title has been published to Pigeonhole it cannot be removed via the integration.

How are Post Nominals handled?

By default post nominals are merged into the name of the speaker in Pigeonhole. If you do not want to publish post nominals configure ‘Should post nominals be published’ in ‘Titles, Post Nominals, Position and Company’

How is the Speakers Company name and Position published?

The speakers Company and Position are published as ‘Brief Description in Pigeonhole. The format for this is ‘Director at Top Co’.

You can configure whether to include the company and position, and change the language for ‘at’ in the ‘Company’ parts of the ‘Titles, Post Nominals, Position and Company’ configuration.

How can I publish automatically?

To schedule publishing scroll down to the ‘Scheduled Publishing’ part of the configuration.

You can then choose whether to publish once per hour, or once per day. If you choose to publish each day the publication will occur around 3am in the timezone of your event.

---

Still can’t find what you’re looking for? Email support@lineupninja.com and one of the team will get back to you as soon as possible.​​​​​