salesforce-mc/marketing-cloud-sdk

The Salesforce Marketing Cloud PHP SDK

1.0.0 2019-11-29 10:47 UTC

README

Overview

The Salesforce Marketing Cloud PHP SDK enables developers to easily access the Salesforce Marketing Cloud.

Supported Features

Environment Requirements

  • PHP 7.3 and later

Download

To consume this SDK, add the Salesforce Marketing Cloud SDK to your project using the following command:

composer require salesforce-mc/marketing-cloud-sdk

Getting Started

Usage scenarios

1.Basic usage

Please note that the configuration in this scenario is taken from the environment variables.


$client = new SalesForce\MarketingCloud\Api\Client();
$assetApi = $client->getAssetApi();

$asset = new SalesForce\MarketingCloud\Model\Asset();

try {
    $result = $assetApi->createAsset($asset);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AssetApi->createAsset: ', $e->getMessage(), PHP_EOL;
}

Environment variables:

  • SFMC_ACCOUNT_ID
  • SFMC_AUTH_BASE_URL (Authentication TSE)
  • SFMC_CLIENT_ID
  • SFMC_CLIENT_SECRET
  • SFMC_COUNTRY_CODE (eg: US)
  • SFMC_KEYWORD (SMS keyword)
  • SFMC_SHORT_CODE (SMS short code)

2.Setting the configuration from code using the configuration builder

use Symfony\Component\DependencyInjection\ContainerBuilder;

$client = new SalesForce\MarketingCloud\Api\Client(null, null, false);

$config = $client->getConfig();
$config->setAccountId('YOUR_ACCOUNT_ID')
    ->setClientId('YOUR_CLIENT_ID')
    ->setClientSecret('YOUR_CLIENT_SECRET')
    ->setAuthBaseUrl('YOUR_AUTH_TSE')
    ->setAccessTokenUrl('YOUR_AUTH_TSE')
    ->setResourceOwnerDetailsUrl('');

$assetApi = $client->getAssetApi();
$asset = new SalesForce\MarketingCloud\Model\Asset();

try {
    $result = $assetApi->createAsset($asset);
    print_r($result);
} catch (Exception $e) {
    echo 'Exception when calling AssetApi->createAsset: ', $e->getMessage(), PHP_EOL;
}

To find more information on how to consume the SDK, Refer to the Regression tests or the Code Samples

Note

Contact us

  • Request a new feature, add a question or report a bug on GitHub.
  • Vote for Popular Feature Requests by making relevant comments and add your reaction. Use a reaction in place of a "+1" comment:
  • 👍 - upvote
  • 👎 - downvote

License

By contributing your code, you agree to license your contribution under the terms of the BSD 3-Clause License.