© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Better Together with AT&T –How the In-App Messaging API Can Add High Value to Your Application
Bill SelphAT&T Sr. Product Marketing Manager, Platform APIs Mobile Broadband Network Services
Richard HarringtonSolutions Architect,AT&T Developer Advocacy Group
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Agenda• What & Why
– Intro to In-App Messaging & Service– API Functions– Benefits, Use Cases & Opportunities
• How – Richard Harrington
• Q&A and Wrap up
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
What is AT&T In-App Messaging?
3rd PartyApps
In AppMessaging
API
Add SMS/MMS capabilities within the 3rd party App
AT&TSend
ReceiveM
ob
ileTa
ble
t, P
C,
We
b
Emerging Devices
Cloud Message Service
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
AT&T Messages Backup & Sync ServiceEnabled by the In-App Messaging API
Storage
SMS & MMS
Integrate Smartphone, Tablet, PC, Web
Sync & Notify across Apps using the API
Consumer Messaging Inbox
per Mobile #
Cloud Message Service
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App Messaging API
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App Messaging API Functions• Single API to send SMS or MMS on behalf of Subscriber’s mobile number• Send to Mobile Number, email or short code to domestic carriers• 1:1 Message or Group & Broadcast Messages
Sending Messages
Account Management
Managed by AT&T
• Retrieve AT&T Subscriber’s Account Status• Record User Consent• Provision AT&T Messages Backup & Sync Service
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
One Click
• Authenticate the AT&T Subscriber
• Provision AT&T Messages Backup & Sync
• Grant Permission to your App to send & receive messages on behalf of user’s mobile number
• Return the Subscriber back to your App
Authentication, Consent & Provisioning
YOUR APPLICATION
(AT&T Customer)
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In App Messaging API Functions
• Retrieve messages (up to 500 at a time)• Filter by state or message type• Delete or Update existing messages status• Sync messages between the Cloud Message Service & Apps
• Register for Notifications• Auto Notify – New & existing message status change• Based on STOMP over Websockets (HTML5)
Notifications
Message InboxManagement
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
The Experience Without In-App Messaging
Engaged in App
Leave App Send SMS
Engaged in App
Le
av
e A
pp
ComposeSend Read Messages
Ba
ck t
o A
pp The Mobile Multi-Tasker & Texter Cycle (M2T2)
Compose
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Benefits & Use Cases
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Benefits of the In-App Messaging API Message from within your AppUsers can send & receive text messages from within your application
Mobile Phone
Tablet/Laptop
Web
Uses single mobile identityMessages appear as originating from their mobile phone number
Drives sustained User engagementNo need to move in an out of the App to send or read messages
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App SMS MessagingSend & receive text messages within your App
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Richard’s Phone – Carrier X
I have an extra ticket for the concert tonight.Want to go?
PC Gaming App – AT&T
Your Gaming App Here
PC Gaming App Use Case - SMS
Domestic Inter-Carrier Messaging within an App
Reply SMS
Send SMS
+1 (976) 555-1212Sure what time and where do you want to meet?
Richard’s PhoneI have an extra ticket for the concert tonight. Want to go?
ComposeMessage
SendPauseGame
Sure what time and where do you want to meet?
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Single Mobile IdentityUse the AT&T Subscriber’s Mobile Number
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
WorkPC App
Walking to carMobile Phone App
Driving HomeConnected Car App
Voice to text
SMS SMS
Single Mobile Identity across Devices & Apps
Walking to Front DoorMobile Phone App
At HomeTablet App
In App Messaging enables the conversation to continue across devices
SMS
976-555-1212
976-555-1212
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App MMS MessagingSend & receive text with media attachments
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Shopping Website – Laptop
Shopping App Use Case – MMS
Shop
ComposeMessage
Send
Jennie’s PhoneGO FOR IT :-)
Best Friend’s Phone
Jennie
10:50AM
(999) 555-1212
In App Messaging enables sustained User engagement
+1(999) 555-1212Hey, You know I can’t pass up a deal! Should I buy them?
Send MMS
Reply
On-Line Shopper
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Creative In-App Messaging Opportunities
Sharing Digital Media Group Coordination Wearable Devices
Parental Controls Connected Car Social & Business Alerts
MessagesMessages
MMS
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Messaging Market Research
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
• 83% of US Mobile users use Messaging Services‑ 96% of the above users use the Text Messaging Service
from their Carrier
• Convenience, Speed and Ease of Use are top reasons Users prefer their Carrier Text Messaging Service
US Addressable Market
AT&T Market Research Aug 2013
In-App Messaging API opens up a Large Addressable Market
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
US Addressable Market
• A large US SMS/MMS market exists • Mobile Users are familiar with the benefits of the technology• As an App Developer you do not have to create the market
In-App Messaging extends the Carrier benefit to your App
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Opportunity: In-App Messaging Apps for PC, Laptops & Tablets
Example: 45+ and Seniors
• Improved Mobile UI has helped increase adoption
• More varied age groups continue to adopt SMS
• Seniors request easier typing features to grow adoption by older users
Messaging Market Sub-Segments
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Key Take Aways• The US Market continues to sustain high text message usage
– Look into US messaging sub-segments for new App opportunities
• Use the In-App Messaging API to enable communications to differentiate and add high value to your App
• Grow your addressable market through AT&T’s large US customer base
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Technical Overview
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Technical Overview• Goals
• Sending messages
• Receiving messages
• Subscribing to Notifications
• Demo
• Q&A
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Goal
Show you just how easy it is to use messaging in your application…
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Get Message Notifications
Send Messages
Receive Messages
The API
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Time for the Technical Stuff
Warning: API Calls Ahead
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Send Message
"addresses":
["tel:2065551212",
"short:225647",
"text": "Hello world",
"subject": "Hi",
"isGroup": true
Up to 10 phone numbers, short codes, or email addresses
MMS content including Subject, audio, pictures, and movies
Group Messages
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Get Messages"messageId" : "WU23435", "from" : {"value": "+12065551212"}, "recipients" : [{"value":"+14255551212"}, {"value":”[email protected]"}], "timeStamp" : "2012-01-14T12:00:00", "text" : "This is a Group MMS text only message", "isFavorite" : true, "isUnread" : false, "type" : "TEXT", "typeMetaData":{}, "isIncoming" : "true"
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
"messageId":"a123","isUnread":true
Update Message Status
Existing Message StatusUnread – Read - Deleted
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Message Notifications
YourApplication
AT&T API Gateway
Subscribe
Message
Message
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Sending a MessageAn Actual API Call…
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
DEMO
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Demo Application• “Let’s Go!”
• Asks a group of people to vote
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Demonstrates• Getting User Consent
• Receiving SMS sent to a Short Code
• Sending In-App Messages
• Receiving In-App Messages
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
ComposeMessage My Contacts
Demo App – Let’s Go!
SendMessage
Show Selections
Message:
To: Mobile #, email or Short code
Blue Man Group
David Copperfield
Criss Angel
Penn & Teller
Michael Jackson ONE
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Demo TimeWhat is Safer?
1. BASE Jumping
2. White Water Rafting
3. Skateboarding with a Video Camera
4. Showing a Live Demo
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Under the Hood
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Getting Consenthttps://auth-api.att.com/oauth/authorize?
client_id=je8qcsejz9nvpwvrvyk3gycokq&
scope=immn,mim
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Text the word all to 288463 from the device
you wish to associate with this service.
Use the button below, when present, to open the
messaging app on this device.
waiting for text message
Getting Consent
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Getting an Access TokenPOST /oauth/token HTTP/1.1
Content-Type: application/x-www-form-urlencoded
Accept: application/json
client_id=abcdef&client_secret=ghijkl&
grant_type=authorization_code&
code=mnopqrstuv
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Access Token Response{
"access_token":”abcdefghi",
"token_type": "bearer",
"expires_in":"157679999",
"refresh_token":”lmnopqrstuv"
}
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Getting Message HeadersGET /rest/1/MyMessages?HeaderCount=20
Authorization: Bearer 31dbab574c01ac901af7
Accept: application/json
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Message Headers Response• "MessageId":"WU23435", • "From":"+14258028620", • "To": ["+14257850159", "[email protected]” ], • "Subject":"Hello", • "Received":"2012-01-14T12:00:00", • "Text":"This is a Group MMS text only message", • "Favorite":"True", • "Read":"False", • "Type":”MMS", • "Direction":"IN”
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
SummaryIn-App Messaging Lets You
• Integrate messaging into your Application
• Send & Receive messages on behalf of a subscriber
• Supports text, audio, pictures & video
• Receive notifications
• Integrate your App with AT&T’s Cloud Message Service
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Call to Action• More information at: http://developer.att.com/
– Documentation
– Sample Apps
• Start building your App with integrated SMS and MMS capabilities
• Tell us about your project – Contact http://developer.att.com/support
We are available to address your questions today between 4:00 - 4:45PM
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Q&A
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Thank You
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Backup Slides
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App Messaging API Fast Facts• RESTful APIs
• Supports HTML5 and Microsoft Environments
• Supports JSON, XML or URL Request and JSON or XML Response
• Send Only or Send and Receive SMS or MMS – supports US Cross Carrier Messaging
• Integrates with AT&T Messages Backup and Sync Service
• User Authentication via O-Auth 2.0
• For use with AT&T post paid customers with SMS/MMS account
• Requires AT&T customer consent to send/receive messages from yourApp via their mobile number
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In App Messaging Functions API Function Description
Account Management Check if subscriber account is provisioned for AT&T Messages Cloud Service, and if not, provision the account for the subscriber – Internal API Calls, Managed by AT&T
Send Message Send messages on behalf of the subscriber’s mobile number.Send Only Apps do not require an AT&T Cloud Service
Message Management
Retrieve Messages Retrieve subscriber’s messages
Updating Messages Update subscriber’s messages, read, unread and delete
Message Synchronization 2-way synchronization of messages since last accessed (Cloud to App and App to Cloud)
Message Notification Notification updates on new or updated messages (status changes – read/unread, deleted messages, etc.).
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App Messaging API OperationsOperation Description
Send Message Send SMS and MMS on behalf of subscriber, with subscriber’s consent. Subscriber’s mobile number will be communicated to the target recipients as the sender's address.
Get Message List Enables applications to request meta-data for one or more Subscriber Messages from the AT&T Cloud Message Service. The Application will request a block of messages from AT&T. AT&T will return a list of messages, returned in received order starting with the most recent. The maximum number of messages retrieved by the operation is 500.
Get Message Get a single message from a subscriber’s message inbox.
Get Message Content Uses information returned by the Get Message List operation to enable applications to fetch one or more subscriber messages from the AT&T Messages environment.
Get Messages Delta Provides capability to check for updates by passing in a client state. This is typically used when a client goes from being offline to becoming online.
Update Messages Allows the developer to update the flags that are associated with a collection of messages. The developer can pass in any number of messages.
Update Message Allows the developer to update the flags that are associated with a specific message. The developer passes in the messaged.
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App Messaging API Operations
Operation Description
Delete Messages Gives the developer the ability to delete messages in an inbox. The messages are passed in the query string in the request.
Delete Message Gives the developer the ability to delete a specific message in an inbox.
Create Message Index Allows the developer to create an index cache for the subscriber’s inbox. In order to accommodate advanced filtering options, an index cache is used on the enabler
Get Message Index Info Allows the developer to get the state, status and message count of the index cache for the subscriber’s inbox.
Get Notification Connection details
Provides capability to retrieve details about the credentials, endpoint and resource information to setup a notification connection. This API needs to be invoked before a STOMP connection is established to subscribe for notifications.
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
In-App Messaging API ResourcesOperation Resource URL - https://api.att.com Operation/HTTP Scope
Send Message /myMessages/v2/messages POST IMMN
Get Message List /myMessages/v2/messages GET MIM
Get Message /myMessages/v2/messages/{messageId} GET MIM
Get Message Content /myMessages/v2/messages/{ messageId}/parts/{partId} GET MIM
Get Messages Delta /myMessages/v2/delta GET MIM
Update Messages /myMessages/v2/messages PUT MIM
Update Message /myMessages/v2/messages/{messageId} PUT MIM
Delete Messages /myMessages/v2/messages DELETE MIM
Delete Message /myMessages/v2/messages/{messageId} DELETE MIM
Create Message Index /myMessages/v2/messages/index POST MIM
Get Message Index Info /myMessages/v2/messages/index/info GET MIM
Get Notification Connection details
/myMessages/v2/notificationConnectionDetails GET
© 2014 AT&T Intellectual Property. All rights reserved. AT&T, the AT&T logo and all other marks contained herein are trademarks of AT&T Intellectual Property and/or AT&T affiliated companies. All other marks contained herein are the property of their respective owners. Information contained herein is not an offer, commitment, representation or warranty by AT&T and is subject to change. Mention of a specific company or entity is not an endorsement by AT&T.
Message Content SupportMediaSMS Content ISO-8859-1
Text Supported Media Text Wrapping ASCII UTF-8 UTF-16
MMS Content
Still Image JPEG
Bitmap GIF87a ( excluding animations)
GIF89a (excluding animations)
3GPP Video H.263/AMR-NB (.3gp) MPEG-4/AMR-NB (.3gp)
MP4 Video MPEG-4/AAC-LC (.3gp, .mp4)
Sampled audio MP3 AAC-LC (.3gp, .mp4)(M4A files are unsupported)
Personal Information Manager (PIM) vCard 2.1 vCalendar 1.0
Synchronized Multimedia Integration Language (SMIL)
MMS SMIL User configurable Timed multimedia