twilio/sdk

TwiML

• Add classes for all TwiML verbs.

Sync

• Add support for Streams

Wireless

• Added DataSessions sub-resource to Sims.

Library

• Add lastRequest and lastResponse properties to CurlClient to help debugging.

Api

• Update status enum for Recordings to include 'failed'
• Add errorCode property on Recordings

Chat

• Add mutable parameters for channel, members and messages

Video

• New media_region parameter when creating a room, which controls which region media will be served out of.

Api

• Add VoiceReceiveMode {'voice', 'fax'} option to IncomingPhoneNumber UPDATE requests

Chat

• Add channel message media information
• Add service instance message media information

Preview

• Removed 'email' from bulk_exports configuration api [bi]. No migration plan needed because api has not been used yet.
• Add DeployedDevices.

Sync

• Add support for Service Instance unique names

Api

• Add New wireless usage keys added
• Add auto_correct_address param for Addresses create and update
• Add ChatGrant to Grants and deprecate IpMessagingGrant

Video

• Add video_codec enum and video_codecs parameter, which can be set to either VP8 or H264 during room creation.
• Restrict recordings page size to 100

This release adds Beta and Preview products to main artifact.

Previously, Beta and Preview products were only included in the alpha artifact. They are now being included in the main artifact to ease product discoverability and the collective operational overhead of maintaining multiple artifacts per library.

Api

• Remove unused encryption_type property on Recordings (breaking change)
• Update status enum for Messages to include 'accepted'

Messaging

• Fix incorrectly typed capabilities property for PhoneNumbers.

Notify

• Add ToBinding optional parameter on Notifications resource creation. Accepted values are json strings.

Preview

• Add sms_application_sid to HostedNumberOrders.

Taskrouter

• Fully support conference functionality in reservations.

• This release drops official support for PHP 5.3 and PHP 5.4, which were EOL'd in 2014 and 2015 respectively.
• Reinstate getPage functionality.

• Add locality field to AvailablePhoneNumbers.
• Add origin field to IncomingPhoneNumbers.
• Add in_locality parameter to AvailablePhoneNumbers.
• Add origin parameter to IncomingPhoneNumbers.
• Add announce_url parameter to Participants.
• Add announce_url_method parameter to Participants.
• Add getPage() methods to lists to begin paging starting from a given url.

• Rename room Recordings resource to RoomRecordings to avoid class name conflict (backwards incompatible).

• Add support for video.twilio.com.

• Add support for Twilio Chat v2
• Add recordingChannels, recordingStatusCallback, recordingStatusCallbackMethod, sipAuthUsername, sipAuthPassword, region, conferenceRecordingStatusCallback, conferenceRecordingStatusCallbackMethod optional parameters to conference participant resource.
• Add support for setting DEBUG_HTTP_TRAFFIC=true environment varibale to dump request and response information. Thanks @kevinburke, PR #394.
• Add deprecation warning to ConversationsGrant, it is being replaced by VideoGrant.

• Add TaskRouterGrant.
• Update VideoGrant.
  • Add room as preferred grant granularity.
  • Deprecate setting configurationProfileSid on grant.

• Add validityPeriod parameter to Message creation

• Add Answering Machine Detection to Call creation

• Add WRAPPING entry to Status for Task

• Twilio Chat

  • Add limits map to Service
  • Add limitsChannelMembers and limitsUserChannels field to ServiceUpdater

Breaking Changes, refer to [Upgrade Guide][upgrade]

• Restore ability to transfer IncomingPhoneNumbers between accounts.

Breaking Changes, refer to [Upgrade Guide][upgrade]

• Remove end of life Sandbox resource (backwards incompatible).
• Support new accounts.twilio.com subdomain and products.
  • client->accounts now references accounts.twilio.com instead of Accounts resource (backwards incompatible).
• Fix resources throwing error on instantiation when response is missing a field.
• Chat:
  • Add order as filter when listing Messages.
  • Messages .read(), .stream(), .page() now accept options array as first parameter (backwards incompatible).

Breaking Changes, refer to [Upgrade Guide][upgrade]

• Fix broken default page size for all reads, thanks @rtek! Issue [#388] (https://github.com/twilio/twilio-php/issues/388)

  • Credential List Mappings, IP ACL Mappings, SIP Domains.

• Fix incorrect types documentation of links/subresourceUri fields on various resources. Was incorrectly documented as string, actual type was an array.

• Fix some properties incorrectly documented as string when actually were array types.

• Fix boolean parameters did not accept boolean values, now accept both boolean and strings for backwards compatibility.

• Add emergencyEnabled field to Addresses.

• Add price and callSid fields to Recordings.

  • Allow filtering recordings list by call sid.

• Add trunkSid, emergencyStatus, and emergencyAddressSid fields to IncomingPhoneNumbers.

• Add messagingServiceSid field to Messages.

• Add url and/or links fields to various resources which were missing them.

  • Lookups PhoneNumber, Monitor Events.

• Add subresourceUri fields to resources where missing.

• Accept DateTime inputs for date parameters for various resources, previously expected strings.

• Remove uri field from Pricing Phone Number Countries resource (backwards incompatible).

• Properly deserialize date times for various resources (backwards incompatible).

• Remove library support for date inquality for resources that don't support them (backwards incompatible).

• Message body parameter now required on update (backwards incompatible).

• Require friendlyName on Queue creation (backwards incompatible).

• Taskrouter

  • Add url and/or links fields to resources where missing.
    • Activities, Reservations, TaskQueue Statistics, WorkerStatistics, WorkersStatistics, Worker, Workflow, WorkflowStatistics, WorkspaceStatistics, Tasks, TaskQueues, Workspaces.
  • Add addons, taskQueueFriendlyName, workflowFriendlyName fields to Tasks.
  • Add taskOrder field to TaskQueues, allow updating taskOrder.
  • Add prioritizeQueueOrder field to Workspace.
  • Allow filtering Tasks list by evaluateTaskAttributes, ordering, hasAddons.
  • Disallow filtering Tasks list by taskChannel, was never supported.
  • Allow filtering TaskQueues list by workerSid and taskOrder.
  • Allow updating prioritizeQueueOrder on Workspaces.
  • Demote friendlyName to optional parameter when updating Activities (backwards incompatible).
  • Demote available to optional parameter when creating Activities (backwards incompatible).
  • Demote workflowSid and attributes to optional parameters when creating a Task (backwards incompatible).
  • Remove friendlyName as optional parameter when fetching Task Queue Statistics (backwards incompatible).
  • WorkspaceStatistics now take DateTime objects when filtering by startDate and endDate (backwards incompatible).

• Chat

  • Add Secret field to Chat credentials and allow setting on create and update.
  • Add Channel Invite resource.
  • Add lastConsumedMessageIndex and lastConsumptionTimestamp fields to Channel Members.
  • Body parameter no longer required for updating a message.
  • Add attributes and index fields to Messages.
  • Add membersCount and messagesCount to Channels.
  • Add UserChannel resource.
  • Add attributes, friendlyName, isOnline, isNotifiable, links to Users.
  • Add reachabilityEnabled, preWebhookUrl, postWebhookUrl, webhookMethod, webhookFilters, notifications to Services.
  • Fix webhooks, notifications updating on Service by separating into individual parameters.
  • Remove ability to update type on Channels, was never supported by api (backwards incompatible).
  • Demote update Message body to optional parameter (backwards incompatible).

• Conferences

  • Add status field to Participants.
  • Add ability to add/remove Participants via the API.
  • Add ability to end Conferences via the API.
  • Add region and subresourceUri fields to Conference.

• Marketplace

  • Add resources for Recording AddOns.
    • AddOnResults.
    • AddOnResultPayloads.
  • Add getAddOnResults helper to Recordings.

• Add InstanceResource::toArray()

Thanks to @johnpaulmedina for this suggestion.

• Add Video Grant

Breaking Changes, refer to [Upgrade Guide][upgrade]

• Remove required parameter friendlyName on IP Messaging/Chat Role update.
• Alphabetize domain mounts
• Better exceptions when an error is encountered loading a page of records, the exception class has been corrected from DeserializeException to RestException.

Breaking Changes, refer to [Upgrade Guide][upgrade]

• Demote password to optional and remove unsupported username on SIP Credential Update
• Demote RoleSid to optional and add optional attributes, friendlyName parameters on IP Messaging/Chat User creation
• Add optional attributes parameter on IP Messaging/Chat message creation

Breaking Changes, refer to [Upgrade Guide][upgrade]

• New options for Conference Participant management.
  • Adds support for hold, holdUrl, holdMethod
• Mount ip-messaging under the new chat domain
• Demote assignmentCallbackUrl from a required argument to optional for Taskrouter Workflows to better support client managed reservations.

Changes the way that uris are constructed to make sure that they are always rawurlencode()d by the twilio-php library

Updates the output of the unit tests on failure introducing a new method, assertRequest(), that will output a friendlier error message when a request is missing in the Holodeck network mock.

Optional arguments are handled in the twilio-php by accepting an associative array of optional keys and values to pass to the API. This makes it easy to support all the optional parameters, but lessens developer ergonomics, since it doesn't provide any inline documentation or autocomplete for optional arguments.

This change introduces new Options builders that support 2 new ways for specifying optional arguments that provide better usability.

<?php

use Twilio\Values;
use Twilio\Rest\Client;
use Twilio\Rest\Api\V2010\Account\CallOptions;

$client = new Client();

// Original Way (5.0.x)
$client->calls->create(
    '+14155551234',
    '+14155557890',
    array(
        'applicationSid' => 'AP123',
        'method' => 'POST',
    )
);

// Options Factory
$client->calls->create(
    '+14155551234',
    '+14155557890',
    CallOptions::create(
        Values::NONE,
        'AP123',
        'POST'
    )
);

// Options Builder
$client->calls->create(
    '+14155551234',
    '+14155557890',
    CallOptions::create()->setApplicationSid('AP123')
                         ->setMethod('POST')
);

The Options Factory provides fully documented optional arguments for every optional argument supported by the Resource's Action. This is a fast way to handle endpoints that have a few optional arguments.

The Options Builder provides fully documented setters for every optional arguments, this is great for actions that support a large number of optional arguments, so that you don't need to provided tons of default values.

Both of these options work well with autocompleting IDEs.

• Adds the ability to pass options into Twilio\Http\CurlClient. This feature brings CurlClient closer to parity with Services_Twilio_TinyHttp.

• Fixes a bug where reading lists with a $limit and no $pageSize would cause a divide by zero error.
• Sanity check in the Twiml generator
• Better tests for Twiml and Version

Add the VERSIONS.md to explain the versioning strategy, first alpha release.

New Major Version

The newest version of the twilio-php helper library, supporting PHP 5.3+

This version brings a host of changes to update and modernize the twilio-php helper library. It is auto-generated to produce a more consistent and correct product.

• Migration Guide
• Full API Documentation
• General Documentation