# Yespo integration

> Yespo (also sold as eSputnik; both brands share one API) is an omnichannel customer data platform: contacts, segments, orders, events, and Email, SMS, Viber, Mobile Push, App Inbox and Telegram messages and broadcasts.

- Authentication: apiKey

## Tools (110)

- **Add application tokens**: The method is used for adding Telegram application tokens. Send tokens in batches of up to 3000 per request.
- **Add base App Inbox message**: The method is used for creating basic App Inbox messages.
- **Add base Email message**: The method is used for creating a base Email message. If the template parameter is set to true, the message is created as a template.
- **Add base Mobile Push message**: The method is used for creating new Mobile Push message.
- **Add base SMS message**: The method is used for creating basic SMS messages.
- **Add base Telegram bot message**: The method is used for creating basic Telegram bot messages.
- **Add base Viber message**: The method is used for creating base Viber message.
- **Add domain**: The method registers the domain sent in the body params for use in web tracking or widgets. Only one domain can be registered per organization.
- **Add emails to unsubscribed list**: The method is used for adding email addresses to the list of unsubscribed contacts.
- **Add one web push domain**: The method is used for adding one domain for web push notifications.
- **Add orders**: The method is used for transferring orders. Sending an order again with the same externalOrderId updates the existing record instead of creating a second one. The method only writes orders.
- **Add/update a contact**: Creates or updates contacts in real-time. The guide on bulk contact uploading and updating is available at the link. Request example.
- **Add/update contacts**: The method adds new contacts and updates existing contacts. Asynchronous processing is used; requests may be handled in a different order or concurrently.
- **Add/update contacts from external file**: The method is used to import or update the contacts from an external file. The method creates new contacts and updates existing ones.
- **Add/update translated App Inbox message**: The method is used for updating or adding language versions for the basic App Inbox message.
- **Add/update translated Email message**: The method is used for updating or adding language versions for the basic Email message.
- **Add/update translated Mobile Push message**: The method is used for updating or adding language versions for the basic Mobile Push message.
- **Add/update translated Telegram message**: The method is used for updating or adding language versions for the basic Telegram message.
- **Attach contact to static segment**: Attach contact to static segment by contact ids or external customer ids
- **Cancel scheduled broadcast**: The method is used for cancelling a scheduled broadcast.
- **Change token activity**: The method is used for changing activity status of the mobile token.
- **Configure product feeds**: Configure product feeds
- **Contact recommendations based on web tracking**: The method returns recommendations for a contact based on the web tracking. NOTE: Version 2 API methods do not require escaping in nested JSON.
- **Create broadcast**: The method is used for creating broadcasts for Email, SMS, Mobile Push, Web Push, Viber, Telegram channels.
- **Delete App Inbox message**: The method is used for deleting the base App Inbox message.
- **Delete base Mobile Push message**: The method is used for deleting the base Mobile Push message.
- **Delete basic Email message**: The method is used for deleting the basic Email message.
- **Delete contact**: The method is used for deleting a contact identified by contactID.
- **Delete contact by externalCustomerId**: The method is used for deleting a contact identified by externalCustomerId.
- **Delete events**: The method is used for deleting events occurred during selected period.
- **Delete from static segment**: The method deletes contacts from a static segment by contact ids or external customer ids. If don't specify any ids, all contacts will be deleted from the segment.
- **Delete language version of Mobile Push message**: The method is used for deleting the language version of the base Mobile Push message.
- **Delete orders**: This endpoint schedules an asynchronous order deletion job.
- **Delete SMS message**: The method is used for deleting the base SMS message.
- **Delete Telegram bot message**: The method is used for deleting the base Telegram bot message.
- **Delete translated App Inbox message**: The method is used for deleting the language version of the basic App Inbox message.
- **Delete translated Email message**: The method is used for deleting the translation of the basic Email message.
- **Delete translated SMS message**: The method is used for deleting the language version of the basic SMS message.
- **Delete translated Telegram bot message**: The method is used for deleting the language version of the basic Telegram bot message.
- **Delete translated Viber message**: The method is used for deleting language version of base Viber message.
- **Delete Viber message**: The method is used for deleting base Viber message.
- **Delete web push domain**: The method is used for deleting a domain for web push notifications.
- **Generate API token**: The method is used for generating a token for bearer authentication. Use the token only if the basic authentication is not appropriate for you.
- **Generate event v3**: Sends any backend events from websites and mobile apps to our system. Secure for sensitive data.For sending frontend events, mobile apps should use SDK.The request example is available at the link.
- **Generate past events V3**: The method is used for transferring the available event data from your CRM or other data store to our system. Workflows are not launched for these events. You can send up to 500 events per a request.
- **Get account info**: The method returns the account name.
- **Get additional fields**: The method returns contact additional fields grouped into lists, including field keys, field types, allowed values, and validation metadata.
- **Get a Mobile Push message**: The method returns Mobile Push message including language versions. By default, a rate limit of 500 requests per hour applies.
- **Get broadcast info**: The method is used for getting broadcast information.
- **Get broadcasts**: The method is used for getting a list of broadcasts.
- **Get contact**: The method returns the available information about the contact identified by the contact ID.
- **Get contact ID by Mobile Push token**: The method is used for getting the ID of a contact using the Mobile Push token ID.
- **Get contact import status**: The method is used for getting the status of the contact import session by the asynchronous ID of the session.
- **Get contacts activity**: Returns activity records for the messages sent to your contacts over the period you specify.
- **Get contacts from a segment**: The method is used to search for all contacts in a segment.
- **Get contact's message history**: The method returns the contact's message history. Supported media types: Email, SMS, Viber, Mobile Push, Web Push, App Inbox, Telegram.
- **Get contact subscriptions**: The method is used for getting the names of categories a contact subscribed for.
- **Get domain**: The method returns your organization's domain. The response is empty if no domain is found.
- **Get email by contactID**: The method is used for getting the email addresses of contacts by their contactID.
- **Get Email interfaces**: The method is used for getting Email interfaces (sender names).
- **Get Email message**: The method returns the content, title, and sender details of a message identified by the internal ID – html and css separately. By default, a rate limit of 500 requests per hour applies.
- **Get Email message view link**: This method is used to get a link to view the Email message. By default, a rate limit of 500 requests per hour applies.
- **Get organization balance**: The method returns the balance for the account.
- **Get organization billing history**: The method returns the billing history of the account.
- **Get organization subscriptions**: The method returns subscription categories for the organization.
- **Get preprocessor file status**: The method is used for retrieving the preprocessor file uploading session status using the asynchronous session identifier.
- **Get product feeds configuration**: Get product feeds configuration
- **Get promotional codes**: The method returns a list of all available promotional codes as JSON string.
- **Get script**: The method returns the script for your account. The domain must exist for an organization before getting a script.
- **Get segments**: The method searches for and returns the available segments.
- **Get single message status**: The method is used for getting the status of a single message.
- **Get SMS interfaces**: The method is used for getting SMS interfaces (alpha names).
- **Get SMS message**: The method returns content, title, sender and text of an SMS identified by its internal SMS message ID. By default, a rate limit of 500 requests per hour applies.
- **Get the App Inbox message**: The method returns the App Inbox message found using its ID. By default, a rate limit of 500 requests per hour applies.
- **Get the app Telegram bot message**: The method returns the Telegram bot message found using its ID. By default, a rate limit of 500 requests per hour applies.
- **Get the number of available promotional codes**: The method returns the number of available promo codes.
- **Get the Viber message**: The method returns Viber message found by ID. By default, a rate limit of 500 requests per hour applies.
- **Get token activity**: The method returns activity status of the mobile token: {"active":true} or {"active":false}.
- **Get web push domains**: The method returns the list of domains registered for web push notifications.
- **Get web push script**: The method returns the web push script for the specified domain.
- **Get workflows**: The method searches for and returns the available workflows.
- **Mute application tokens**: The method mutes notifications to Telegram users having tokens. Read more.
- **Remove emails from unsubscribed list**: The method is used for removing email addresses from the list of unsubscribed contacts.
- **Search for App Inbox messages**: The method is used to search for mobile App Inbox messages using a part of the name or a tag. The method returns a maximum of 500 messages per request.
- **Search for contacts**: Search for contacts. The method returns max 500 results. The total amount of contacts is in the TotalCount header.
- **Search for Email messages**: The method is used to search for Email messages using a part of their name or a tag. By default, a rate limit of 500 requests per hour applies.
- **Search for Mobile Push messages**: The method is used to search for Mobile Push messages using a part of name or a tag.
- **Search for SMS messages**: The method is used to search for SMS messages using a part of their names or a tag. By default, a rate limit of 500 requests per hour applies.
- **Search for Telegram bot messages**: The method is used to search for Telegram bot messages using a part of name or a tag. By default, a rate limit of 500 requests per hour applies.
- **Search for Viber messages**: The method is used to search for Viber messages using a part of name or a tag. By default, a rate limit of 500 requests per hour applies. The method returns a maximum of 500 messages per request.
- **Send Email message**: The method is used for sending an Email message to a contact. A new contact is created if no contact with such email address exists. ⚠️ Not recommended for OTP passwords.
- **Send prepared message**: The method is used for sending a prepared message to one or many contacts. You can create broadcasts for Email, SMS, Mobile Push, Web Push, Viber, Telegram bot channels.
- **Send SMS message**: The method is used for sending an SMS message to a contact. A new contact is created if no contact with such phone number exists.
- **Send Viber message**: The method is used for sending a Viber message to a contact. A new contact is created if no contact with such phone number exists.
- **Subscribe a contact**: The method is used for the integration of subscription forms. If a contact does not exist, it is created with the non-confirmed email.
- **Unmute application tokens**: The method unmutes notifications to Telegram users having tokens. Read more.
- **Update base Mobile Push message**: The method is used for updating the base Mobile Push message.
- **Update base SMS message**: The method is used for updating the base SMS message.
- **Update base Telegram bot message**: The method is used for updating the base Telegram bot message.
- **Update base Viber message**: The method is used for updating base Viber message.
- **Update basic Email message**: The method is used for updating the basic Email message.
- **Update contact**: The method is used to update the contact's data, except for the contact ID field. In case of updating a deleted contact, this contact is restored.
- **Update contact subscriptions**: The method is used for updating the categories that a contact subscribed for.
- **Update file for preprocessor**: The methods updates the data of a preprocessor file uploaded using the Upload file for preprocessor method.
- **Update interaction status**: The method is used for sending message status using interaction_id. This ID is sent along with data in a message. Example for Mobile Push: "es_interaction_id": "2E2E831C-486C-41F9-8E8D-BCD6B7A51A7A".
- **Update the base App Inbox message**: The method is used for updating the base App Inbox message.
- **Update translated SMS message**: The method is used for updating the language version of SMS message.
- **Update translated Viber message**: The method is used for updating language version of base Viber message.
- **Upload file for preprocessor**: The method is used for uploading a file for the preprocessor from an external repository.
- **Upload promotional codes**: Upload promo codes from CSV or JSON. Existing promotional codes are updated.

Connect Yespo in General Input: https://www.generalinput.com/apps/yespo