• Home
• co.aurasphere.botmill
• fb-botmill
• 1.2.1
• source code
• FbBotMillThreadSettingsConfiguration.java

×

Project download

Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $

You can buy this project and download/modify it how often you want.

co.aurasphere.botmill.fb.threadsettings.FbBotMillThreadSettingsConfiguration Maven / Gradle / Ivy

/*
 * MIT License
 *
 * Copyright (c) 2016 BotMill.io
 * 
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be included in all
 * copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 * SOFTWARE.
 */
package co.aurasphere.botmill.fb.threadsettings;

import java.util.ArrayList;
import java.util.List;

import org.slf4j.Logger;
import org.slf4j.LoggerFactory;

import co.aurasphere.botmill.fb.FbBotDefinition;
import co.aurasphere.botmill.fb.internal.util.network.NetworkUtils;
import co.aurasphere.botmill.fb.model.outcoming.template.button.Button;
import co.aurasphere.botmill.fb.model.outcoming.template.button.BuyButton;
import co.aurasphere.botmill.fb.model.outcoming.template.button.PaymentSummary;
import co.aurasphere.botmill.fb.model.outcoming.template.button.PostbackButton;
import co.aurasphere.botmill.fb.model.outcoming.template.button.WebUrlButton;
import co.aurasphere.botmill.fb.model.threadsettings.CallToActionsRequest;
import co.aurasphere.botmill.fb.model.threadsettings.DomainActionType;
import co.aurasphere.botmill.fb.model.threadsettings.ThreadState;
import co.aurasphere.botmill.fb.model.threadsettings.WhitelistDomainRequest;
import co.aurasphere.botmill.fb.model.threadsettings.greeting.SetGreetingTextRequest;
import co.aurasphere.botmill.fb.model.threadsettings.payment.PaymentDevModeAction;
import co.aurasphere.botmill.fb.model.threadsettings.payment.PaymentSettings;

/**
 * Class which handles the configuration of the Facebook Messenger Platform
 * Thread Settings (for more informations, see the link below). The methods of
 * this class needs to be called only once and thus shouldn't be put on the
 * class that implements {@link FbBotDefinition}. The best way of handling the
 * configuration would be defining your own class with a main method and put the
 * call on it.
 *
 * @author Donato Rimenti
 * @see Facebook's Thread Settings Documentation
 */
public class FbBotMillThreadSettingsConfiguration {

	/**
	 * The logger.
	 */
	private static final Logger logger = LoggerFactory
			.getLogger(FbBotMillThreadSettingsConfiguration.class);

	/**
	 * Instantiates a new FbBotMillThreadSettingsConfiguration.
	 */
	private FbBotMillThreadSettingsConfiguration() {
	}

	/**
	 * This method is used to add any payment settings needed.
	 * 
	 * @param paymentSettings
	 *            the payment settings object.
	 * @see Payments settings
	 */
	public static void addPaymentSettings(PaymentSettings paymentSettings) {
		if (paymentSettings == null) {
			logger.error("FbBotMill validation error: Payment Settings can't be null or empty!");
			return;
		}
		NetworkUtils.postThreadSetting(paymentSettings);
	}

	/**
	 * Sets the greeting message for the bot. The Greeting Text is only rendered
	 * the first time the user interacts with a the Page on Messenger.
	 *
	 * @param message
	 *            the greeting message to show.
	 * @see Facebook's Greeting Text Documentation
	 */
	public static void setGreetingMessage(String message) {
		if (message == null || message.isEmpty()) {
			logger.error("FbBotMill validation error: Greeting message can't be null or empty!");
			return;
		}
		SetGreetingTextRequest request = new SetGreetingTextRequest(message);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Sets the Get Started Button for the bot. The Get Started button is only
	 * rendered the first time the user interacts with a the Page on Messenger.
	 * When this button is tapped, the defined payload will be sent back with a
	 * postback received callback.
	 *
	 * @param payload
	 *            the payload to return when the button is tapped.
	 * @see Facebook's Get Started Button Documentation
	 */
	public static void setGetStartedButton(String payload) {
		if (payload == null || payload.isEmpty()) {
			logger.error("FbBotMill validation error: Get Started Button payload can't be null or empty!");
			return;
		}
		Button button = new PostbackButton(null, null, payload);
		List buttonList = new ArrayList();
		buttonList.add(button);
		CallToActionsRequest request = new CallToActionsRequest(
				ThreadState.NEW_THREAD, buttonList);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Removes the current Get Started Button.
	 * 
	 * @see #setGetStartedButton(String)
	 */
	public static void deleteGetStartedButton() {
		CallToActionsRequest request = new CallToActionsRequest(
				ThreadState.NEW_THREAD, null);
		NetworkUtils.delete(request);
	}

	/**
	 * Sets a Persistent Menu of buttons which is always available to the user.
	 * This menu should contain top-level actions that users can enact at any
	 * point. Having a persistent menu easily communicates the basic
	 * capabilities of your bot for first-time and returning users. The menu can
	 * be invoked by a user, by tapping on the 3-caret icon on the left of the
	 * composer.
	 *
	 * @param buttons
	 *            a list of {@link Button} (max 5 elements) to use as menu. The
	 *            buttons can only be {@link PostbackButton} or
	 *            {@link WebUrlButton}. Phone buttons are not supported.
	 * @see Facebook's Persistent Menu Documentation
	 */
	public static void setPersistentMenu(List buttons) {
		if (buttons == null || buttons.isEmpty() || buttons.size() > 5) {
			logger.error("FbBotMill validation error: Persistent Menu Buttons can't be null or empty and must be less than 5!");
			return;
		}
		CallToActionsRequest request = new CallToActionsRequest(
				ThreadState.EXISTING_THREAD, buttons);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Removes the current Persistent Menu.
	 * 
	 * @see #setPersistentMenu(List)
	 */
	public static void deletePersistentMenu() {
		CallToActionsRequest request = new CallToActionsRequest(
				ThreadState.EXISTING_THREAD, null);
		NetworkUtils.delete(request);
	}

	/**
	 * Adds a list of domains that needs to be "white listed".
	 *
	 * @param whiteListDomains
	 *            the list of domains in String.
	 * @see Facebook's Messenger Platform Domain Whitelisting Thread Settings
	 *      Documentation
	 */
	public static void setWhiteListDomains(List whiteListDomains) {
		WhitelistDomainRequest request = new WhitelistDomainRequest(
				whiteListDomains, DomainActionType.ADD);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Adds a single domain on the list of domains that needs to be
	 * "white listed".
	 *
	 * @param domain
	 *            the domain that needs to be "white listed".
	 * @see Facebook's Messenger Platform Domain Whitelisting Thread Settings
	 *      Documentation
	 */
	public static void addWhiteListDomain(String domain) {
		WhitelistDomainRequest request = new WhitelistDomainRequest();
		request.addWhiteListedDomain(domain);
		request.setDomainActionType(DomainActionType.ADD);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Removes a single domain on the list of domains that needs to be
	 * "white listed".
	 *
	 * @param domain
	 *            the domain that needs to be removed.
	 * @see Facebook's Messenger Platform Domain Whitelisting Thread Settings
	 *      Documentation
	 */
	public static void deleteWhiteListDomain(String domain) {
		WhitelistDomainRequest request = new WhitelistDomainRequest();
		request.addWhiteListedDomain(domain);
		request.setDomainActionType(DomainActionType.REMOVE);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Removes a list of domains that are currently "white listed".
	 *
	 * @param whiteListDomains
	 *            the list of domains that needs to be removed.
	 * @see Facebook's Messenger Platform Domain Whitelisting Thread Settings
	 *      Documentation
	 */
	public static void deleteWhiteListDomains(List whiteListDomains) {
		WhitelistDomainRequest request = new WhitelistDomainRequest(
				whiteListDomains, DomainActionType.REMOVE);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Adds a list of testers for payments. You can add payment test users so
	 * that their credit card won't be charged during your development. Once
	 * added, it will impact both Buy Button and Webview Extension integrations,
	 * any payment send to these users will be a dummy charge. If you are only
	 * testing {@link BuyButton}, consider using the
	 * {@link PaymentSummary#setTestPayment(boolean)} flag which is simpler for
	 * testing.
	 * 
	 * @param paymentTestersIds
	 *            the testers app-scoped IDs to add to the testers list.
	 * @since 1.2.0
	 * @see Facebook's Messenger Platform Payments Thread Settings
	 *      Documentation
	 */
	public static void addPaymentsTesters(List paymentTestersIds) {
		PaymentSettings request = new PaymentSettings();
		request.setPaymentTesters(paymentTestersIds);
		request.setPaymentDevModeAction(PaymentDevModeAction.ADD);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Adds a single tester for payments. You can add payment test users so that
	 * their credit card won't be charged during your development. Once added,
	 * it will impact both Buy Button and Webview Extension integrations, any
	 * payment send to these users will be a dummy charge. If you are only
	 * testing {@link BuyButton}, consider using the
	 * {@link PaymentSummary#setTestPayment(boolean)} flag which is simpler for
	 * testing.
	 * 
	 * @param paymentTesterId
	 *            the tester app-scoped ID to add to the testers list.
	 * @since 1.2.0
	 * @see Facebook's Messenger Platform Payments Thread Settings
	 *      Documentation
	 */
	public static void addPaymentsTester(String paymentTesterId) {
		PaymentSettings request = new PaymentSettings();
		List paymentTestersIds = new ArrayList();
		request.setPaymentTesters(paymentTestersIds);
		request.setPaymentDevModeAction(PaymentDevModeAction.ADD);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Removes a single tester for payments. You can add payment test users so
	 * that their credit card won't be charged during your development. Once
	 * added, it will impact both Buy Button and Webview Extension integrations,
	 * any payment send to these users will be a dummy charge. If you are only
	 * testing {@link BuyButton}, consider using the
	 * {@link PaymentSummary#setTestPayment(boolean)} flag which is simpler for
	 * testing.
	 * 
	 * @param paymentTesterId
	 *            the tester app-scoped ID to remove from the testers list.
	 * @since 1.2.0
	 * @see Facebook's Messenger Platform Payments Thread Settings
	 *      Documentation
	 */
	public static void removePaymentsTester(String paymentTesterId) {
		PaymentSettings request = new PaymentSettings();
		List paymentTestersIds = new ArrayList();
		request.setPaymentTesters(paymentTestersIds);
		request.setPaymentDevModeAction(PaymentDevModeAction.REMOVE);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Removes a list of testers for payments. You can add payment test users so
	 * that their credit card won't be charged during your development. Once
	 * added, it will impact both Buy Button and Webview Extension integrations,
	 * any payment send to these users will be a dummy charge. If you are only
	 * testing {@link BuyButton}, consider using the
	 * {@link PaymentSummary#setTestPayment(boolean)} flag which is simpler for
	 * testing.
	 * 
	 * @param paymentTestersIds
	 *            the testers app-scoped IDs to remove from the testers list.
	 * @since 1.2.0
	 * @see Facebook's Messenger Platform Payments Thread Settings
	 *      Documentation
	 */
	public static void removePaymentsTesters(List paymentTestersIds) {
		PaymentSettings request = new PaymentSettings();
		request.setPaymentTesters(paymentTestersIds);
		request.setPaymentDevModeAction(PaymentDevModeAction.REMOVE);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Sets the payment public key. The payment_public_key is used to encrypt
	 * sensitive payment data sent to you.
	 * 
	 * @param publicKey
	 *            the public key to set.
	 * @see Facebook's Messenger Platform Payments Thread Settings
	 *      Documentation
	 * @since 1.2.0
	 * @see Facebook's Messenger Platform Creating Encryption Documentation
	 */
	public static void setPaymentsPublicKey(String publicKey) {
		PaymentSettings request = new PaymentSettings();
		request.setPrivacyUrl(publicKey);
		NetworkUtils.postThreadSetting(request);
	}

	/**
	 * Sets the payment privacy Url. The payment_privacy_url will appear in
	 * Facebook's payment dialogs and people will be able to view these terms.
	 * 
	 * @param privacyUrl
	 *            the privacy Url to set.
	 * @since 1.2.0
	 * @see Facebook's Messenger Platform Payments Thread Settings
	 *      Documentation
	 */
	public static void setPaymentsPrivacyUrl(String privacyUrl) {
		PaymentSettings request = new PaymentSettings();
		request.setPrivacyUrl(privacyUrl);
		NetworkUtils.postThreadSetting(request);
	}

	/*
	 * (non-Javadoc)
	 * 
	 * @see java.lang.Object#toString()
	 */
	@Override
	public String toString() {
		return "FbBotMillThreadSettingsConfiguration []";
	}

}