TelstraUpdatedApi.ipynb

{
 "cells": [
  {
   "cell_type": "code",
   "execution_count": 1,
   "metadata": {},
   "outputs": [],
   "source": [
    "import secrets  # Custom secrets.py file containing my confidential data!\n",
    "import requests"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 1: Generate an OAuth2 Token from the key and secret"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 2,
   "metadata": {},
   "outputs": [],
   "source": [
    "import json"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 4,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<Response [200]>\n"
     ]
    }
   ],
   "source": [
    "oauth_data = {\n",
    "    'grant_type': 'client_credentials',\n",
    "    'client_id': secrets.TELSTRA_CLIENT_KEY,\n",
    "    'client_secret': secrets.TELSTRA_CLIENT_SECRET,\n",
    "    'scope': \"NSMS\"\n",
    "}\n",
    "\n",
    "oauth_response = requests.post(\"https://tapi.telstra.com/v2/oauth/token\", data=oauth_data)\n",
    "print(oauth_response)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 5,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'access_token': '8gtKteIGyrYPcR3joM4G6rsdfYu5',\n",
       " 'token_type': 'Bearer',\n",
       " 'expires_in': '3599'}"
      ]
     },
     "execution_count": 5,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "token = oauth_response.json()\n",
    "token"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 6,
   "metadata": {},
   "outputs": [],
   "source": [
    "auth_headers = {\n",
    "    'authorization': f\"Bearer {token['access_token']}\",\n",
    "    'cache-control': 'no-cache',\n",
    "    'content-type': 'application/json'\n",
    "}"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 7,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'authorization': 'Bearer 8gtKteIGyrYPcR3joM4G6rsdfYu5',\n",
       " 'cache-control': 'no-cache',\n",
       " 'content-type': 'application/json'}"
      ]
     },
     "execution_count": 7,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "auth_headers"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 2: Register your receive number"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 12,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'bnum': []}"
      ]
     },
     "execution_count": 12,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "requests.get(\"https://tapi.telstra.com/v2/messages/freetrial/bnum\", headers=auth_headers).json()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 13,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<Response [200]>\n"
     ]
    }
   ],
   "source": [
    "register_data = {\n",
    "    'bnum': secrets.MY_PHONE_NUMBER\n",
    "}\n",
    "\n",
    "register_response = requests.post('https://tapi.telstra.com/v2/messages/freetrial/bnum', headers=auth_headers,\n",
    "                                json=register_data)\n",
    "print(register_response)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 54,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Phone number registered\n"
     ]
    }
   ],
   "source": [
    "if register_response.json()['bnum'] == secrets.MY_PHONE_NUMBER:\n",
    "    print(\"Phone number registered\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 57,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "Phone number registration confirmed\n"
     ]
    },
    {
     "data": {
      "text/plain": [
       "['+61340013554']"
      ]
     },
     "execution_count": 57,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "bnum_response = requests.get('https://tapi.telstra.com/v2/messages/freetrial/bnum', headers=auth_headers)\n",
    "if secrets.MY_PHONE_NUMBER in bnum_response.json()['bnum']:\n",
    "    print(\"Phone number registration confirmed\")"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 2: Provision a \"From\" phone number"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 48,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<Response [405]>\n"
     ]
    }
   ],
   "source": [
    "provisioning_data = {\n",
    "    'activeDays': 30,\n",
    "#     'notifyURL': ''\n",
    "}\n",
    "\n",
    "provision_response = requests.post('https://tapi.telstra.com/v2/messages/provisioning/subscriptions',\n",
    "                                   json=provisioning_data, headers=auth_headers)\n",
    "print(provision_response)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 49,
   "metadata": {},
   "outputs": [],
   "source": [
    "r = provision_response.request"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 50,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'User-Agent': 'python-requests/2.22.0', 'Accept-Encoding': 'gzip, deflate', 'Accept': '*/*', 'Connection': 'keep-alive', 'authorization': 'Bearer 8gtKteIGyrYPcR3joM4G6rsdfYu5', 'cache-control': 'no-cache', 'content-type': 'application/json', 'Content-Length': '18'}"
      ]
     },
     "execution_count": 50,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "r.headers"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 51,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'status': '405',\n",
       " 'code': 'FREE-TRIAL-ERROR',\n",
       " 'message': 'A Free Trial number may already have been provisioned. Please email telstradev@team.telstra.com for support.'}"
      ]
     },
     "execution_count": 51,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "provision_response.json()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 3: Get the phone number subscription"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 52,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<Response [404]>\n"
     ]
    }
   ],
   "source": [
    "subscription_response = requests.get('https://tapi.telstra.com/v2/messages/provisioning/subscriptions',\n",
    "                                    headers=auth_headers,)\n",
    "print(subscription_response)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 53,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'status': '404',\n",
       " 'code': 'RESOURCE-NOT-FOUND',\n",
       " 'message': 'Invalid resource. Refer to API docs at https://dev.telstra.com'}"
      ]
     },
     "execution_count": 53,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "subscription_response.json()"
   ]
  },
  {
   "cell_type": "markdown",
   "metadata": {},
   "source": [
    "## Step 4: Send Message"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 22,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "12"
      ]
     },
     "execution_count": 22,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "len(\"PythnCharmrs\")"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 41,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "'+61340013554'"
      ]
     },
     "execution_count": 41,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "secrets.MY_PHONE_NUMBER"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 39,
   "metadata": {},
   "outputs": [
    {
     "name": "stdout",
     "output_type": "stream",
     "text": [
      "<Response [404]>\n"
     ]
    }
   ],
   "source": [
    "send_message_data = {\n",
    "    'to': secrets.MY_PHONE_NUMBER,\n",
    "    'body': \"Hello from Python Charmers!\",\n",
    "    \"validity\": 5,\n",
    "    \"scheduledDelivery\": 1,\n",
    "    \"replyRequest\": False,\n",
    "    \"priority\": False,\n",
    "    \"receiptOff\": True\n",
    "}\n",
    "\n",
    "send_response = requests.post(\"https://tapi.telstra.com/v2/messages/sms\", headers=auth_headers,\n",
    "                             json=send_message_data)\n",
    "\n",
    "print(send_response)"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": 40,
   "metadata": {},
   "outputs": [
    {
     "data": {
      "text/plain": [
       "{'status': '404',\n",
       " 'code': 'RESOURCE-NOT-FOUND',\n",
       " 'message': 'Invalid resource. Refer to API docs at https://dev.telstra.com'}"
      ]
     },
     "execution_count": 40,
     "metadata": {},
     "output_type": "execute_result"
    }
   ],
   "source": [
    "send_response.json()"
   ]
  },
  {
   "cell_type": "code",
   "execution_count": null,
   "metadata": {},
   "outputs": [],
   "source": []
  }
 ],
 "metadata": {
  "kernelspec": {
   "display_name": "Python 3",
   "language": "python",
   "name": "python3"
  },
  "language_info": {
   "codemirror_mode": {
    "name": "ipython",
    "version": 3
   },
   "file_extension": ".py",
   "mimetype": "text/x-python",
   "name": "python",
   "nbconvert_exporter": "python",
   "pygments_lexer": "ipython3",
   "version": "3.7.6"
  }
 },
 "nbformat": 4,
 "nbformat_minor": 4
}