All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.unblu.webapi.jersey.v3.api.PersonsApi Maven / Gradle / Ivy

There is a newer version: 7.51.0
Show newest version
package com.unblu.webapi.jersey.v3.api;

import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

import jakarta.ws.rs.core.GenericType;

import com.unblu.webapi.jersey.v3.invoker.ApiClient;
import com.unblu.webapi.jersey.v3.invoker.ApiException;
import com.unblu.webapi.jersey.v3.invoker.ApiResponse;
import com.unblu.webapi.jersey.v3.invoker.Configuration;
import com.unblu.webapi.jersey.v3.invoker.Pair;
import com.unblu.webapi.model.v3.EPersonSource;
import com.unblu.webapi.model.v3.NotificationCountData;
import com.unblu.webapi.model.v3.NotificationCountForConversationsData;
import com.unblu.webapi.model.v3.NotificationCountForConversationsRequest;
import com.unblu.webapi.model.v3.PersonData;
import com.unblu.webapi.model.v3.PersonQuery;
import com.unblu.webapi.model.v3.PersonResult;
import com.unblu.webapi.model.v3.PersonStateData;
import com.unblu.webapi.model.v3.PersonStateQuery;
import com.unblu.webapi.model.v3.PersonStateResult;
import com.unblu.webapi.model.v3.PersonsAddAutoPauseNotificationsReasonBody;
import com.unblu.webapi.model.v3.PersonsPauseNotificationsBody;
import com.unblu.webapi.model.v3.PersonsRemoveAutoPauseNotificationsReasonBody;
import com.unblu.webapi.model.v3.PersonsSetAwayBody;
import com.unblu.webapi.model.v3.PersonsSetStatusMessageBody;

public class PersonsApi {
	private ApiClient apiClient;

	public PersonsApi() {
		this(Configuration.getDefaultApiClient());
	}

	public PersonsApi(ApiClient apiClient) {
		this.apiClient = apiClient;
	}

	public ApiClient getApiClient() {
		return apiClient;
	}

	public void setApiClient(ApiClient apiClient) {
		this.apiClient = apiClient;
	}

	/**
	 * addAutoPauseNotificationsReason Add an AutoPauseNotificationsReason for a person. By calling this service the notifications for the given user will
	 * automatically be paused for the specified amount of time.<br> If several auto pause reasons are added, the notifications will be automatically paused
	 * until the last auto pause reason is removed or times out.<br> Note: This will only take effect on the pauseNotificationsState if the person's
	 * pauseNnotificationsMode is set to AUTO.<br>
	 * 
	 * @param personId ID of the person we want to add the auto pause to (required)
	 * @param personsAddAutoPauseNotificationsReasonBody (required)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsAddAutoPauseNotificationsReason(String personId, PersonsAddAutoPauseNotificationsReasonBody personsAddAutoPauseNotificationsReasonBody) throws ApiException {
		return personsAddAutoPauseNotificationsReasonWithHttpInfo(personId, personsAddAutoPauseNotificationsReasonBody).getData();
	}

	/**
	 * addAutoPauseNotificationsReason Add an AutoPauseNotificationsReason for a person. By calling this service the notifications for the given user will
	 * automatically be paused for the specified amount of time.<br> If several auto pause reasons are added, the notifications will be automatically paused
	 * until the last auto pause reason is removed or times out.<br> Note: This will only take effect on the pauseNotificationsState if the person's
	 * pauseNnotificationsMode is set to AUTO.<br>
	 * 
	 * @param personId ID of the person we want to add the auto pause to (required)
	 * @param personsAddAutoPauseNotificationsReasonBody (required)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsAddAutoPauseNotificationsReasonWithHttpInfo(String personId, PersonsAddAutoPauseNotificationsReasonBody personsAddAutoPauseNotificationsReasonBody) throws ApiException {
		Object localVarPostBody = personsAddAutoPauseNotificationsReasonBody;

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsAddAutoPauseNotificationsReason");
		}

		// verify the required parameter 'personsAddAutoPauseNotificationsReasonBody' is set
		if (personsAddAutoPauseNotificationsReasonBody == null) {
			throw new ApiException(400, "Missing the required parameter 'personsAddAutoPauseNotificationsReasonBody' when calling personsAddAutoPauseNotificationsReason");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/addAutoPauseNotificationsReason"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * autoPauseNotifications Set a person's pauseNotificationsState automatically, based on their ongoing interactions in Unblu and any
	 * AutoPauseNotificationsReasons in place for the person via the Web API. <p> Calling this endpoint sets the person's pauseNotificationsMode to AUTO.
	 * As a result, their pauseNotificationsState will be ON whenever there is at least one active AutoPauseNotificationsReason and OFF otherwise.<br>
	 * 
	 * @param personId The ID of the person whose pauseNotificationsMode should be set to AUTO (required)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsAutoPauseNotifications(String personId) throws ApiException {
		return personsAutoPauseNotificationsWithHttpInfo(personId).getData();
	}

	/**
	 * autoPauseNotifications Set a person's pauseNotificationsState automatically, based on their ongoing interactions in Unblu and any
	 * AutoPauseNotificationsReasons in place for the person via the Web API. <p> Calling this endpoint sets the person's pauseNotificationsMode to AUTO.
	 * As a result, their pauseNotificationsState will be ON whenever there is at least one active AutoPauseNotificationsReason and OFF otherwise.<br>
	 * 
	 * @param personId The ID of the person whose pauseNotificationsMode should be set to AUTO (required)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsAutoPauseNotificationsWithHttpInfo(String personId) throws ApiException {
		Object localVarPostBody = new HashMap<>();

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsAutoPauseNotifications");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/autoPauseNotifications"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {

		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * createOrUpdateBot Updates and returns an existing bot person or creates and returns a bot person if absent.<br>
	 * 
	 * @param personData person data (required)
	 * @param expand (optional)
	 * @return PersonData
	 * @throws ApiException if fails to make API call
	 */
	public PersonData personsCreateOrUpdateBot(PersonData personData, String expand) throws ApiException {
		return personsCreateOrUpdateBotWithHttpInfo(personData, expand).getData();
	}

	/**
	 * createOrUpdateBot Updates and returns an existing bot person or creates and returns a bot person if absent.<br>
	 * 
	 * @param personData person data (required)
	 * @param expand (optional)
	 * @return ApiResponse<PersonData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsCreateOrUpdateBotWithHttpInfo(PersonData personData, String expand) throws ApiException {
		Object localVarPostBody = personData;

		// verify the required parameter 'personData' is set
		if (personData == null) {
			throw new ApiException(400, "Missing the required parameter 'personData' when calling personsCreateOrUpdateBot");
		}

		// create path and map variables
		String localVarPath = "/persons/createOrUpdateBot";

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		localVarQueryParams.addAll(apiClient.parameterToPairs("", "expand", expand));

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * createOrUpdateVirtual Updates and returns an existing virtual person or creates and returns a virtual person if absent.<br>
	 * 
	 * @param personData person data (required)
	 * @param expand (optional)
	 * @return PersonData
	 * @throws ApiException if fails to make API call
	 */
	public PersonData personsCreateOrUpdateVirtual(PersonData personData, String expand) throws ApiException {
		return personsCreateOrUpdateVirtualWithHttpInfo(personData, expand).getData();
	}

	/**
	 * createOrUpdateVirtual Updates and returns an existing virtual person or creates and returns a virtual person if absent.<br>
	 * 
	 * @param personData person data (required)
	 * @param expand (optional)
	 * @return ApiResponse<PersonData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsCreateOrUpdateVirtualWithHttpInfo(PersonData personData, String expand) throws ApiException {
		Object localVarPostBody = personData;

		// verify the required parameter 'personData' is set
		if (personData == null) {
			throw new ApiException(400, "Missing the required parameter 'personData' when calling personsCreateOrUpdateVirtual");
		}

		// create path and map variables
		String localVarPath = "/persons/createOrUpdateVirtual";

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		localVarQueryParams.addAll(apiClient.parameterToPairs("", "expand", expand));

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * getBySource Returns the person that represents the user identified by the source ID<br>
	 * 
	 * @param personSource The source of the person (optional)
	 * @param sourceId The identifier of the source for the person's information<br> <ul> <li>For agents and visitors whose identity is
	 * propagated and whose person source is \"VIRTUAL\", the source ID is the value of the propagated \"userId\" field which is saved as ${link
	 * User.username} in the User entity. <li>For users whose identity is managed in Unblu (and whose person source is therefore \"USER_DB\"), the
	 * source ID is the ${link User.id} of the user represented by the person. <li>For anonymous visitors, the source ID is a random String. <li>For the
	 * concierge bot, the source ID is the String \"concierge-bot-person-id\". </ul> (optional)
	 * @param expand (optional)
	 * @return PersonData
	 * @throws ApiException if fails to make API call
	 */
	public PersonData personsGetBySource(EPersonSource personSource, String sourceId, String expand) throws ApiException {
		return personsGetBySourceWithHttpInfo(personSource, sourceId, expand).getData();
	}

	/**
	 * getBySource Returns the person that represents the user identified by the source ID<br>
	 * 
	 * @param personSource The source of the person (optional)
	 * @param sourceId The identifier of the source for the person's information<br> <ul> <li>For agents and visitors whose identity is
	 * propagated and whose person source is \"VIRTUAL\", the source ID is the value of the propagated \"userId\" field which is saved as ${link
	 * User.username} in the User entity. <li>For users whose identity is managed in Unblu (and whose person source is therefore \"USER_DB\"), the
	 * source ID is the ${link User.id} of the user represented by the person. <li>For anonymous visitors, the source ID is a random String. <li>For the
	 * concierge bot, the source ID is the String \"concierge-bot-person-id\". </ul> (optional)
	 * @param expand (optional)
	 * @return ApiResponse<PersonData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsGetBySourceWithHttpInfo(EPersonSource personSource, String sourceId, String expand) throws ApiException {
		Object localVarPostBody = new HashMap<>();

		// create path and map variables
		String localVarPath = "/persons/getBySource";

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		localVarQueryParams.addAll(apiClient.parameterToPairs("", "personSource", personSource));
		localVarQueryParams.addAll(apiClient.parameterToPairs("", "sourceId", sourceId));
		localVarQueryParams.addAll(apiClient.parameterToPairs("", "expand", expand));

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {

		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * getNotificationCount Returns `NotificationCountData` for a personId<br>
	 * 
	 * @param personId (required)
	 * @return NotificationCountData
	 * @throws ApiException if fails to make API call
	 */
	public NotificationCountData personsGetNotificationCount(String personId) throws ApiException {
		return personsGetNotificationCountWithHttpInfo(personId).getData();
	}

	/**
	 * getNotificationCount Returns `NotificationCountData` for a personId<br>
	 * 
	 * @param personId (required)
	 * @return ApiResponse<NotificationCountData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsGetNotificationCountWithHttpInfo(String personId) throws ApiException {
		Object localVarPostBody = new HashMap<>();

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsGetNotificationCount");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/getNotificationCount"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {

		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * getNotificationCountForConversations Returns The sum of all notifications the given person has across the provided conversations. <p> Note: Only
	 * existing conversations the given person is participating in are taken into account.<br>
	 * 
	 * @param personId (required)
	 * @param notificationCountForConversationsRequest (required)
	 * @return NotificationCountForConversationsData
	 * @throws ApiException if fails to make API call
	 */
	public NotificationCountForConversationsData personsGetNotificationCountForConversations(String personId, NotificationCountForConversationsRequest notificationCountForConversationsRequest) throws ApiException {
		return personsGetNotificationCountForConversationsWithHttpInfo(personId, notificationCountForConversationsRequest).getData();
	}

	/**
	 * getNotificationCountForConversations Returns The sum of all notifications the given person has across the provided conversations. <p> Note: Only
	 * existing conversations the given person is participating in are taken into account.<br>
	 * 
	 * @param personId (required)
	 * @param notificationCountForConversationsRequest (required)
	 * @return ApiResponse<NotificationCountForConversationsData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsGetNotificationCountForConversationsWithHttpInfo(String personId, NotificationCountForConversationsRequest notificationCountForConversationsRequest) throws ApiException {
		Object localVarPostBody = notificationCountForConversationsRequest;

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsGetNotificationCountForConversations");
		}

		// verify the required parameter 'notificationCountForConversationsRequest' is set
		if (notificationCountForConversationsRequest == null) {
			throw new ApiException(400, "Missing the required parameter 'notificationCountForConversationsRequest' when calling personsGetNotificationCountForConversations");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/getNotificationCountForConversations"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * pauseNotifications Pause notifications for a person. This changes the person's pauseNotificationsMode and pauseNotificationsState to ON for the specified
	 * period. <p> Note: This overrides any automatic pause of notifications in place. Notification auto-pausing resumes once the period specified is
	 * over.<br>
	 * 
	 * @param personId The ID of the person to pause notifications for (required)
	 * @param personsPauseNotificationsBody (required)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsPauseNotifications(String personId, PersonsPauseNotificationsBody personsPauseNotificationsBody) throws ApiException {
		return personsPauseNotificationsWithHttpInfo(personId, personsPauseNotificationsBody).getData();
	}

	/**
	 * pauseNotifications Pause notifications for a person. This changes the person's pauseNotificationsMode and pauseNotificationsState to ON for the specified
	 * period. <p> Note: This overrides any automatic pause of notifications in place. Notification auto-pausing resumes once the period specified is
	 * over.<br>
	 * 
	 * @param personId The ID of the person to pause notifications for (required)
	 * @param personsPauseNotificationsBody (required)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsPauseNotificationsWithHttpInfo(String personId, PersonsPauseNotificationsBody personsPauseNotificationsBody) throws ApiException {
		Object localVarPostBody = personsPauseNotificationsBody;

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsPauseNotifications");
		}

		// verify the required parameter 'personsPauseNotificationsBody' is set
		if (personsPauseNotificationsBody == null) {
			throw new ApiException(400, "Missing the required parameter 'personsPauseNotificationsBody' when calling personsPauseNotifications");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/pauseNotifications"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * read Returns a `PersonData` by id<br>
	 * 
	 * @param id the personId (optional)
	 * @param expand (optional)
	 * @return PersonData
	 * @throws ApiException if fails to make API call
	 */
	public PersonData personsRead(String id, String expand) throws ApiException {
		return personsReadWithHttpInfo(id, expand).getData();
	}

	/**
	 * read Returns a `PersonData` by id<br>
	 * 
	 * @param id the personId (optional)
	 * @param expand (optional)
	 * @return ApiResponse<PersonData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsReadWithHttpInfo(String id, String expand) throws ApiException {
		Object localVarPostBody = new HashMap<>();

		// create path and map variables
		String localVarPath = "/persons/read";

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		localVarQueryParams.addAll(apiClient.parameterToPairs("", "id", id));
		localVarQueryParams.addAll(apiClient.parameterToPairs("", "expand", expand));

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {

		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * readState Returns a `PersonStateData` by personId<br>
	 * 
	 * @param personId (optional)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsReadState(String personId) throws ApiException {
		return personsReadStateWithHttpInfo(personId).getData();
	}

	/**
	 * readState Returns a `PersonStateData` by personId<br>
	 * 
	 * @param personId (optional)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsReadStateWithHttpInfo(String personId) throws ApiException {
		Object localVarPostBody = new HashMap<>();

		// create path and map variables
		String localVarPath = "/persons/readState";

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		localVarQueryParams.addAll(apiClient.parameterToPairs("", "personId", personId));

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {

		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "GET", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * removeAutoPauseNotificationsReason Remove the AutoPauseNotificationsReason with the given sourceId for a specific person<br>
	 * 
	 * @param personId The ID of the person we want to remove the auto-pause reason from (required)
	 * @param personsRemoveAutoPauseNotificationsReasonBody (required)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsRemoveAutoPauseNotificationsReason(String personId, PersonsRemoveAutoPauseNotificationsReasonBody personsRemoveAutoPauseNotificationsReasonBody) throws ApiException {
		return personsRemoveAutoPauseNotificationsReasonWithHttpInfo(personId, personsRemoveAutoPauseNotificationsReasonBody).getData();
	}

	/**
	 * removeAutoPauseNotificationsReason Remove the AutoPauseNotificationsReason with the given sourceId for a specific person<br>
	 * 
	 * @param personId The ID of the person we want to remove the auto-pause reason from (required)
	 * @param personsRemoveAutoPauseNotificationsReasonBody (required)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsRemoveAutoPauseNotificationsReasonWithHttpInfo(String personId, PersonsRemoveAutoPauseNotificationsReasonBody personsRemoveAutoPauseNotificationsReasonBody) throws ApiException {
		Object localVarPostBody = personsRemoveAutoPauseNotificationsReasonBody;

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsRemoveAutoPauseNotificationsReason");
		}

		// verify the required parameter 'personsRemoveAutoPauseNotificationsReasonBody' is set
		if (personsRemoveAutoPauseNotificationsReasonBody == null) {
			throw new ApiException(400, "Missing the required parameter 'personsRemoveAutoPauseNotificationsReasonBody' when calling personsRemoveAutoPauseNotificationsReason");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/removeAutoPauseNotificationsReason"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * resumeNotifications Resumes notifications for a person. This changes the person's pauseNotificationsMode and pauseNotificationsState to OFF. <p>
	 * Note: This overrides any automatic pause of notifications.<br>
	 * 
	 * @param personId The ID of the person to resume notifications for (required)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsResumeNotifications(String personId) throws ApiException {
		return personsResumeNotificationsWithHttpInfo(personId).getData();
	}

	/**
	 * resumeNotifications Resumes notifications for a person. This changes the person's pauseNotificationsMode and pauseNotificationsState to OFF. <p>
	 * Note: This overrides any automatic pause of notifications.<br>
	 * 
	 * @param personId The ID of the person to resume notifications for (required)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsResumeNotificationsWithHttpInfo(String personId) throws ApiException {
		Object localVarPostBody = new HashMap<>();

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsResumeNotifications");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/resumeNotifications"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {

		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * search Search for persons in the current account<br>
	 * 
	 * @param personQuery (required)
	 * @param expand (optional)
	 * @return PersonResult
	 * @throws ApiException if fails to make API call
	 */
	public PersonResult personsSearch(PersonQuery personQuery, String expand) throws ApiException {
		return personsSearchWithHttpInfo(personQuery, expand).getData();
	}

	/**
	 * search Search for persons in the current account<br>
	 * 
	 * @param personQuery (required)
	 * @param expand (optional)
	 * @return ApiResponse<PersonResult>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsSearchWithHttpInfo(PersonQuery personQuery, String expand) throws ApiException {
		Object localVarPostBody = personQuery;

		// verify the required parameter 'personQuery' is set
		if (personQuery == null) {
			throw new ApiException(400, "Missing the required parameter 'personQuery' when calling personsSearch");
		}

		// create path and map variables
		String localVarPath = "/persons/search";

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		localVarQueryParams.addAll(apiClient.parameterToPairs("", "expand", expand));

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * searchByState Search for persons in the current account by state<br>
	 * 
	 * @param personStateQuery (required)
	 * @return PersonStateResult
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateResult personsSearchByState(PersonStateQuery personStateQuery) throws ApiException {
		return personsSearchByStateWithHttpInfo(personStateQuery).getData();
	}

	/**
	 * searchByState Search for persons in the current account by state<br>
	 * 
	 * @param personStateQuery (required)
	 * @return ApiResponse<PersonStateResult>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsSearchByStateWithHttpInfo(PersonStateQuery personStateQuery) throws ApiException {
		Object localVarPostBody = personStateQuery;

		// verify the required parameter 'personStateQuery' is set
		if (personStateQuery == null) {
			throw new ApiException(400, "Missing the required parameter 'personStateQuery' when calling personsSearchByState");
		}

		// create path and map variables
		String localVarPath = "/persons/searchByState";

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * setAway Defines if a person should be shown as AWAY or ONLINE when they're logged in. <p> If the endpoint is called with \"true\", the
	 * person's online state will be set to AWAY, if it's called with \"false\" the person's online state will be set to ONLINE. <p> If
	 * the person in question is logged in, the change in their online state takes effect immediately. If they're not logged in, their online state will be set
	 * when they log in again.<br>
	 * 
	 * @param personId The ID of the person to set the online state for (required)
	 * @param personsSetAwayBody (required)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsSetAway(String personId, PersonsSetAwayBody personsSetAwayBody) throws ApiException {
		return personsSetAwayWithHttpInfo(personId, personsSetAwayBody).getData();
	}

	/**
	 * setAway Defines if a person should be shown as AWAY or ONLINE when they're logged in. <p> If the endpoint is called with \"true\", the
	 * person's online state will be set to AWAY, if it's called with \"false\" the person's online state will be set to ONLINE. <p> If
	 * the person in question is logged in, the change in their online state takes effect immediately. If they're not logged in, their online state will be set
	 * when they log in again.<br>
	 * 
	 * @param personId The ID of the person to set the online state for (required)
	 * @param personsSetAwayBody (required)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsSetAwayWithHttpInfo(String personId, PersonsSetAwayBody personsSetAwayBody) throws ApiException {
		Object localVarPostBody = personsSetAwayBody;

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsSetAway");
		}

		// verify the required parameter 'personsSetAwayBody' is set
		if (personsSetAwayBody == null) {
			throw new ApiException(400, "Missing the required parameter 'personsSetAwayBody' when calling personsSetAway");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/setAway"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}

	/**
	 * setStatusMessage Sets a person's status message. Setting it to null deletes the current status message (if present).<br>
	 * 
	 * @param personId The ID of the person we want to set a status message for (required)
	 * @param personsSetStatusMessageBody (required)
	 * @return PersonStateData
	 * @throws ApiException if fails to make API call
	 */
	public PersonStateData personsSetStatusMessage(String personId, PersonsSetStatusMessageBody personsSetStatusMessageBody) throws ApiException {
		return personsSetStatusMessageWithHttpInfo(personId, personsSetStatusMessageBody).getData();
	}

	/**
	 * setStatusMessage Sets a person's status message. Setting it to null deletes the current status message (if present).<br>
	 * 
	 * @param personId The ID of the person we want to set a status message for (required)
	 * @param personsSetStatusMessageBody (required)
	 * @return ApiResponse<PersonStateData>
	 * @throws ApiException if fails to make API call
	 */
	public ApiResponse personsSetStatusMessageWithHttpInfo(String personId, PersonsSetStatusMessageBody personsSetStatusMessageBody) throws ApiException {
		Object localVarPostBody = personsSetStatusMessageBody;

		// verify the required parameter 'personId' is set
		if (personId == null) {
			throw new ApiException(400, "Missing the required parameter 'personId' when calling personsSetStatusMessage");
		}

		// verify the required parameter 'personsSetStatusMessageBody' is set
		if (personsSetStatusMessageBody == null) {
			throw new ApiException(400, "Missing the required parameter 'personsSetStatusMessageBody' when calling personsSetStatusMessage");
		}

		// create path and map variables
		String localVarPath = "/persons/{personId}/setStatusMessage"
				.replaceAll("\\{" + "personId" + "\\}", apiClient.escapeString(personId.toString()));

		// query params
		List localVarQueryParams = new ArrayList();
		Map localVarHeaderParams = new HashMap();
		Map localVarFormParams = new HashMap();

		final String[] localVarAccepts = {
			"application/json"
		};
		final String localVarAccept = apiClient.selectHeaderAccept(localVarAccepts);

		final String[] localVarContentTypes = {
			"application/json"
		};
		final String localVarContentType = apiClient.selectHeaderContentType(localVarContentTypes);

		String[] localVarAuthNames = new String[] { "basicAuth" };

		GenericType localVarReturnType = new GenericType() {
		};
		return apiClient.invokeAPI(localVarPath, "POST", localVarQueryParams, localVarPostBody, localVarHeaderParams, localVarFormParams, localVarAccept, localVarContentType, localVarAuthNames, localVarReturnType);
	}
}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy