README

laravel-twilio

建设中 - Laravel Twilio SDK/API 集成

安装

首先通过 Composer 安装此包。在终端中运行以下命令

composer require collinped/laravel-twilio

如果你使用的是 Laravel 5.5+，这就足够了。

如果你仍然使用更早版本的 Laravel，你需要添加包的服务提供者并别名包。为此，打开你的 config/app.php 文件。

Laravel 5.5 及以下版本集成

为了在你的 Laravel 项目中集成此功能，你需要添加服务提供者。打开 app.php，并将新项目添加到 providers 数组中。

'Collinped\Twilio\TwilioServiceProvider',

这将为你注册一个新的 artisan 命令

• twilio:video-room NAME
• twilio:video-participants SID

配置包

你可以使用以下命令发布配置文件

php artisan vendor:publish --provider="Collinped\Twilio\TwilioServiceProvider" --tag="config"

这是将在 config/twilio.php 中发布的文件内容

将以下值插入你的 .env 文件中

TWILIO_AUTH_TOKEN=
TWILIO_ACCOUNT_SID=
TWILIO_API_KEY=
TWILIO_API_SECRET=

有关获取这些值的说明，请参阅 Twilio 设置。

处理路由

最后，让我们处理路由。在发送 webhook 的应用程序中，你可能配置了一个 URL，你希望 webhook 请求发送到该 URL。在你的应用程序的路由文件（web.php）中，你必须根据指定的方法传递该路由到 Route::post 或 Route::get。以下是一个示例

Route::post('webhook/twilio-video', 'TwilioVideoWebhookController@handleWebhook')->name('twilio.video.webhook');
Route::post('webhook/twilio-voice', 'TwilioVoiceWebhookController@handleWebhook')->name('twilio.voice.webhook');
Route::post('webhook/twilio-sms', 'TwilioSmsWebhookController@handleWebhook')->name('twilio.sms.webhook');
Route::post('webhook/twilio-fax', 'TwilioFaxWebhookController@handleWebhook')->name('twilio.fax.webhook');

在幕后，这将为此包提供的服务器注册一个 POST 或 GET 路由。因为发送 webhook 到你的应用程序没有获取 csrf-token 的方法，你必须将此路由添加到 VerifyCsrfToken 中间件的 except 数组中

protected $except = [
    'webhook/twilio/*', // All Twilio Webhooks
];

或者根据你的应用程序单独为每个端点白名单

protected $except = [
    'webhook/twilio/video', // Twilio Video Webhooks
    'webhook/twilio/voice', // Twilio Voice Webhooks
    'webhook/twilio/voice-recording', // Twilio Voice Recording Webhooks
    'webhook/twilio/sms', // Twilio SMS Webhooks
    'webhook/twilio/conversations', // Twilio Conversations Webhooks
];

Twilio 视频设置

如果你有一个现有的 Twilio 账户，请登录到你的控制台或在此处注册免费试用账户：注册 Twilio

• 导航到“可编程视频”
• 导航到“房间”
• 导航到“设置”
• 将方法设置为“HTTP POST”
• 将“状态回调 URL”输入为

yourdomain.com/webhook/twilio/video

Laravel Twilio 路线图

• Twilio 语音
• Twilio 短信
• Twilio 视频
• Twilio 电话号码
• Twilio 短号
• Twilio 对话
• Twilio Verify
• Twilio Verify 电子邮件 - Sendgrid
• Twilio 可编程无线
• Twilio 代理
• Twilio 查找
• Twilio Flex
• Twilio 助手

许可证

laravel-twilio 是在 MIT 许可下许可的开源软件，许可证地址：MIT 许可