Skip to content

Latest commit

 

History

History
132 lines (114 loc) · 3.35 KB

UPGRADE.md

File metadata and controls

132 lines (114 loc) · 3.35 KB
Raw

Upgrade Guide

All MAJOR version bumps will have upgrade notes posted here.

[2022-10-05] 0.26.x to 1.x.x

NEW FEATURE - Added Support for Twiml Building

The twilio-go library now supports building Twiml elements for applications.

Send a message and redirect with twiml programmable messaging

package main

import (
	"fmt"
	"github.com/twilio/twilio-go/twiml"
)

func main() {
	//Create Verbs
	message := &twiml.MessagingMessage{
		To: "+15017122661",
		From: "+15558675310",
		OptionalAttributes: map[string]string{"community": "user"},
	}
	redirect := &twiml.MessagingRedirect{
		Url: "https://demo.twilio.com/welcome/sms",
	}

	//Create Noun
	body := &twiml.MessagingBody{
		Message: "Hello World!",
	}
	
	//Adding Body element to the Message Verb
	message.InnerElements = []twiml.Element{body}

	//Adding all Verbs to twiml.Messages
	verbList := []twiml.Element{message, redirect}
	twimlResult, err := twiml.Messages(verbList)
	if err == nil {
		fmt.Println(twimlResult)
	} else {
		fmt.Println(err)
	}
}

This will output XML that looks like this:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Message to="+15017122661" from="+15558675310" community="user">
        <Body>Hello World!</Body>
    </Message>
    <Redirect>https://demo.twilio.com/welcome/sms</Redirect>
</Response>

The following example shows Gather with a nested Say. This will read some text to the caller, and allows the caller to enter input at any time while that text is read to them.

package main

import (
	"fmt"
	"github.com/twilio/twilio-go/twiml"
)

func main() {
	//Create Verbs
	gather := &twiml.VoiceGather{
		Input:     "speech dtmf",
		Timeout:   "2",
		NumDigits: "1",
	}
	say := &twiml.VoiceSay{
		Message: "Please press 1 or say sales for sales.",
	}
	
	//Adding Say element to Gather
	gather.InnerElements = []twiml.Element{say}
	
	//Adding all Verbs to twiml.Voice
	verbList := []twiml.Element{gather}
	twimlResult, err := twiml.Voice(verbList)
	if err == nil {
		fmt.Println(twimlResult)
	} else {
		fmt.Println(err)
	}
}

This will output XML that looks like this:

<?xml version="1.0" encoding="UTF-8"?>
<Response>
    <Gather input="speech dtmf" timeout="2" numDigits="1">
        <Say>Please press 1 or say sales for sales.</Say>
    </Gather>
</Response>

NEW VERSION - Added support for version 1.19 of Go

FIXED - Fixed request validator key sorting logic and added support for validating x-www-form-urlencoded requests.

The twilio-go library now supports validating x-www-form-urlencoded requests and has fixed the key sorting logic for validating requests. Checkout the PR for more details.

[2022-05-18] 0.25.x to 0.26.x

CHANGED - Renamed ApiV2010 to Api.

ApiV2010 has now been renamed to Api. This has caused a breaking change for all endpoints located under rest/api/2010.

Send a SMS

//0.2.x 
client := twilio.NewRestClient()

params := &api.CreateMessageParams{}
params.SetFrom("+15017122661")
params.SetBody("body")
params.SetTo("+15558675310")

resp, err := client.ApiV2010.CreateMessage(params)
//1.x.xrc
client := twilio.NewRestClient()

params := &api.CreateMessageParams{}
params.SetFrom("+15017122661")
params.SetBody("body")
params.SetTo("+15558675310")

resp, err := client.Api.CreateMessage(params)