README

免费且开源的市场营销自动化API

要求

• PHP >7.2.5
• cURL支持

Mautic设置

必须在Mautic中启用API。在Mautic中，转到“配置”页面（位于“设置”菜单中），然后在“API设置”下启用Mautic的API。您还可以在此处选择要使用的OAuth2协议。保存配置后，转到“API凭证”页面（位于“设置”菜单中），并创建一个新的客户端。输入请求将从该回调/重定向URI发送。点击应用，然后将客户端ID和客户端密钥复制到使用API的应用程序中。

安装

首先，您需要使用Composer要求该软件包

composer require keepcloud/laravel-mautic-api

之后，从命令行运行composer update。

然后，通过在服务提供者部分添加条目来更新config/app.php。

'providers' => [
	// ...
	'Keepcloud\Mautic\MauticServiceProvider',
],

然后，通过在别名部分添加条目来注册类别名

'aliases' => [
    //.....
    'Mautic' => 'Keepcloud\Mautic\Facades\Mautic',
],

最后，从命令行运行php artisan vendor:publish以发布默认配置文件。这将发布一个名为mautic.php的配置文件、消费者迁移和消费者模型。

运行php artisan migrate迁移命令以在您的数据库中创建消费者表。

配置

您需要在您的应用程序的config目录中找到的mautic.php文件中添加您的客户端ID、客户端密钥和回调URL。

授权

此库仅支持OAuth2授权，您必须创建OAuth2客户端才能使用API。

注册应用程序

为了将您应用程序注册到Mautic，ping此URL，这是一次性注册。

http://your-app/mautic/application/register

用法

在您的控制器中添加Mautic Facade。

use Mautic;

向Mautic发送请求（示例）

在Mautic中创建新的联系人。

$params = array(
    'firstname' => 'Edison',
    'lastname'=> 'Costa',
    'email' => 'edison@keepcloud.io'
);

Mautic::request('POST','contacts/new',$params);

获取所有联系人的列表

Mautic::request('GET','contacts');

获取唯一的联系人

Mautic::request('GET','contacts/1');
//where 1 is unique id for a contact.

删除联系人

Mautic::request('Delete','contacts/1/delete');

并支持许多其他Mautic端点。

Mautic支持的端点列表。

联系人

[
    "contacts",
    "contacts/{id}",
    "contacts/list/fields",
    "contacts/list/owners",
    "contacts/new",
    "contacts/{id}/edit",
    "contacts/{id}/delete",
    "contacts/{id}/notes",
    "contacts/{id}/segments",
    "contacts/{id}/campaigns"
]

资产

[
    "assets",
    "assets/{id}"
]

活动

[
    "campaigns",
    "campaigns/{id}",
    "campaigns/contact/{id}/add/{leadId}",
    "campaigns/contact/{id}/remove/{leadId}"
]

数据

[
    "data",
    "data/{type}",
]

电子邮件

[
    "emails",
    "emails/{id}",
    "emails/{id}/send",
    "emails/{id}/send/lead/{leadId}"
]

表单

[
    "forms",
    "forms/{id}"
]

页面

[
    "pages",
    "pages/{id}"
]

点

[
    "points",
    "points/{id}",
    "points/triggers",
    "points/triggers/{id}"
]

报告

[
    "reports",
    "reports/{id}"
]

段

[
    "segments",
    "segments/contact/{id}/add/{leadId}",
    "segments/contact/{id}/remove/{leadId}"
]

用户

[
    "roles",
    "roles/{id}",
    "users",
    "users/{id}",
    "users/list/roles",
    "users/self",
    "users/{id}/permissioncheck",
]

有关所有可定制的参数，请参阅文档。