snazzy/snazzy-adapter repository overview

⁠snazzy-adapter

Snazzy Contacts⁠ is a smart contact management software for controlling, organizing and managing your contacts data. With Snazzy Contacts⁠ you could manage your entire team contacts(contacts and organizations) and work flexibly together with your colleagues. You are able to maintain your addresses on all devices from everywhere.

This adapter connects Snazzy Contacts⁠ with third-party applications. With this adapter you are able to create different application flows. It supports "Triggers" (e.g. getPersonsPolling, getOrganizationsPolling) as well as "Actions" (e.g. upsertPerson, upsertOrganization, etc.), therefore with this adapter you could both read and fetch data from Snazzy Contacts⁠ and write and save data in Snazzy Contacts⁠.

⁠Before you begin

Before you can use the adapter you must be a registered Snazzy Contacts user. Please visit the home page of snazzycontacts.com⁠ to sign up.

⁠Authorization

Each request to Snazzy Contacts API requires an authorization. You have to pass your token as a Bearer token in headers.

⁠Actions and triggers

The adapter supports the following actions and triggers:

⁠Triggers:

• Get persons - polling (getPersonsPolling.js)
• Get organizations - polling (getOrganizationsPolling.js)

All triggers are of type 'polling' which means that the trigger will be scheduled to execute periodically. It will fetch only these objects from the database that have been modified or created since the previous execution. Then it will emit one message per object that changes or is added since the last polling interval. For this case at the very beginning we just create an empty snapshot object. Later on we attach lastUpdated to it. At the end the entire object should be emitted as the message body.

⁠Actions:

• Upsert person (upsertPerson.js)
• Upsert organization(upsertOrganization.js)

In each trigger and action, before sending a request we get the token from Snazzy Contacts⁠ via calling the function getToken() from snazzy.js file, which is located in directory utils. This function returns a token which is used when we send a request to Snazzy Contacts⁠.

⁠Get persons

Get persons trigger (getPersonsPolling.js) performs a request which fetch all persons saved by a user in Snazzy Contacts⁠.

⁠Get organizations

Get organizations trigger (getOrganizationsPolling.js) performs a request which fetch all organizations saved by a user in Snazzy Contacts⁠.

⁠Upsert person

Upsert person action (upsertPerson.js) updates an existing person if it already exists. Otherwise it creates a new one.

⁠Upsert organization

Upsert organization action (upsertOrganization.js) updates an existing organization if it already exists. Otherwise it creates a new one.

⁠License

Apache-2.0 © Wice GmbH⁠