Download the PHP package i-rocky/laravel-twilio without Composer

laravel-twilio

Installation

Run the following commands

composer require i-rocky/laravel-twilio

php artisan laravel-twilio:install

This should publish the following files

To use TwilioService.js run yarn add axios twilio-client

You can add/update/remove/move the files and use as your wish

Setup

Update config/services.php

Update .env

• TWIML_APP_SID - you need to create a TwiML app for calling from browser
• LARAVEL_TWILIO_BASE_URL - URL prefix for laravel-twilio
• LARAVEL_TWILIO_REJECT_CALL_MESSAGE - reject incoming calls with this message when calling is disabled
• LARAVEL_TWILIO_REPLY_MESSAGE - reply to incoming messages, null for no reply

Now you have to set the Webhook URL in Twilio console.

Replace laravel-twilio in the Webhook URL with the base URL you've set for LARAVEL_TWILIO_BASE_URL in .env

Incoming Calls

Go to your phone number configuration from Active Numbers then click on the desired number.

1. Under Voice & Fax for Accept Incoming select Voice Calls
2. Under Configure With select Webhooks, TwiML Bins, Functions, Studio, or Proxy
3. Under A Call Comes In select Webhook and set the value to https://your-domain.tld/api/laravel-twilio/voice/incoming

Incoming Faxes

Go to your phone number configuration from Active Numbers then click on the desired number.

1. Under Voice & Fax for Accept Incoming select Faxes
2. Under Configure With select Webhooks, TwiML Bins, Functions, Studio, or Proxy
3. Under A Fax Comes In select Webhook and set the value to https://your-domain.tld/api/laravel-twilio/fax/incoming

Incoming Messages

Go to your phone number configuration from Active Numbers then click on the desired number.

1. Under Configure With select Webhooks, TwiML Bins, Functions, Studio, or Proxy
2. Under A Message Comes In select Webhook and set the value to https://your-domain.tld/api/laravel-twilio/message/incoming

Outgoing Calls

Go to TwiML Apps list and select desired app or create a new app

1. Under Voice set the REQUEST URI to https://your-domain.tld/api/laravel-twilio/voice

Usage

Implement Notifiable

Implement notification

If you don't use the to('+number') method in your message construction, you must have phone, phone_number property or routeNotificationForTwilio() method implemented in your Notifiable implementation. The number must start with + followed by country code.

If you don't have username property definition in your Auth provider model, you must implement laravelTwilioIdentity() method to give your agents an identity for calling.

Events

Namespace Rocky\LaravelTwilio\Events

• LaravelTwilioIncomingMessage::class [gives access to IncomingMessage at $event->getMessage()]
• LaravelTwilioIncomingFax::class [gives access to IncomingFax at $event->getFax()]
• LaravelTwilioMessageSent::class [gives access to InstanceResource at $event->getMessage() and $notifiable at $event->getNotifiable()]
• LaravelTwilioMessageSendingFailed::class [gives access to Exception at $event->getException(), Notification at $event->getNotification(), $notifiable at $event->getNotifiable()]
• LaravelTwilioMessageDeliveryReport::class [gives access to MessageDeliveryReport at $event->getReport()]
• LaravelTwilioFaxDeliveryReport::class [gives access to FaxDeliveryReport at $event->getReport()]
• LaravelTwilioInboundCall::class [gives access to InboundCall at $event->getCall()]
• LaravelTwilioInboundCallRejected::class [gives access to InboundCall at $event->getCall()]
• LaravelTwilioOutboundCall::class [gives access to OutboundCall at $event->getCall()]
• LaravelTwilioCallStatusUpdate::class [gives access to CallStatus at $event->getStatus()]
• LaravelTwilioCallRecord::class [gives access to CallRecord at $event->getRecord()]

All the parameters sent by Twilio are available in the instance passed through Event. Some of the frequently used properties are added for autocomplete support.

Example:

The incoming fax implementation is not tested.

Look into the source code for a clearer understanding.