Twilio ====== ******** Overview ******** `Twilio `_ is a messaging platform that allows you to programmatically send and receive SMS messages, send and receive voice calls, and perform other communication functions. This Parsons integration provides methods for fetching messages, accounts, and account usage data. .. note:: Authentication Twilio requires an account SID and an authorization token, which can be found in the `Admin Console `_. For more information about authentication, see the `Twilio API documentation `_. *********** Quick Start *********** ================================= Get Account Usage ================================= To instantiate the ``Twilio`` class, you can either store your Twilio account SID and authorization token as environmental variables (``TWILIO_ACCOUNT_SID`` and ``TWILIO_AUTH_TOKEN``, respectively) or pass them in as arguments: .. code-block:: python from parsons import Twilio # First approach: Use API credentials via environmental variables twilio = Twilio() # Second approach: Pass API credentials as arguments twilio = Twilio(account_sid='account_sid', auth_token='my_auth_token') # Get usage last month twilio.get_account_usage(time_period='last_month') # Get usage for a specific date period twilio.get_account_usage(start_date='2019-10-01', end_date='2019-10-05') # Get usage for a specific resource twilio.get_account_usage(category='sms-inbound') # Get messages from a specific day twilio.get_messages(date_sent='10-01-2019') # Get messages sent to a specific phone number twilio.get_messages(to='9995675309') *** API *** .. autoclass :: parsons.Twilio :inherited-members: