+
{{ error.message }}
+
+ Loading the httpSMS dashboard
+ + httpSMS is an + open source + application that converts your android phone into an SMS gateway so you + can send and receive SMS messages using a simple HTTP API. +
+
+
+```
+
+- [ ] **Step 6: Commit**
+
+```bash
+git add -A
+git commit -m "feat(web): port CopyButton, FixedHeader, BlogAuthorBio, BlogInfo, NuxtLogo"
+```
+
+---
+
+## Task 15: Port Components — FirebaseAuth, MessageThread, MessageThreadHeader
+
+**Files:**
+- Create: `web/app/components/FirebaseAuth.vue`
+- Create: `web/app/components/MessageThread.vue`
+- Create: `web/app/components/MessageThreadHeader.vue`
+
+**IMPORTANT:** Call `vuetify-mcp-get_component_api_by_version` for v-select, v-list, v-list-item, v-menu, v-tooltip, v-sheet, v-progress-linear before writing.
+
+- [ ] **Step 1: Create FirebaseAuth.vue**
+
+This component uses FirebaseUI which must be loaded client-side only. In Nuxt 4, wrap with `+ Start sending messages +
++ {{ phoneCountry(phonesStore.owner) }} +
+
@@ -26,15 +28,9 @@
size="160"
class="mt-8"
color="primary"
- >
+ />
+ Start sending messages +
++ {{ phoneCountry(phonesStore.owner) }} +
+
+
diff --git a/web/app/components/Toast.vue b/web/app/components/Toast.vue
new file mode 100644
index 00000000..c79d33f7
--- /dev/null
+++ b/web/app/components/Toast.vue
@@ -0,0 +1,42 @@
+
+
+
+ {{ error.message }}
+
+
+ Your current billing period usage and limits. +
+ ++ {{ usage.sent_messages ?? 0 }} +
++ Messages Sent +
++ {{ usage.received_messages ?? 0 }} +
++ Messages Received +
++ {{ usage.total_messages ?? 0 }} +
++ Total Messages +
++ {{ usage.message_limit ?? 200 }} +
++ Monthly Limit +
++ Upgrade your plan to send and receive more SMS messages per + month. +
+ ++ $10/month +
+Custom
++ We have added support for end-to-end encryption for SMS messages so + that no one can see the content of the messages you send using httpSMS + except you. You setup an encryption key which you use to encrypt your + messages before making an API request to httpSMS and you also use the + same key to decrypt the messages you receive from httpSMS via our + webhook events. We are using the AES 256 encryption algorithm to + encrypt and decrypt the messages. +
+ ++ Download and install the httpSMS Android app on your phone and set + your encryption key under the App Settings page of the app. + Download the Android app. +
+ ++ We are using AES-256 to encrypt your SMS messages. The encryption key + is hashed with SHA-256 before use and the initialization vector (IV) + is generated for each message. The IV is appended to the encrypted + payload before the final value is base64 encoded. +
+import HttpSms from "httpsms"
+
+const client = new HttpSms("" /* API Key from https://httpsms.com/settings */)
+
+const key = "Password123"
+
+const encryptedMessage = client.cipher.encrypt(key, "This is a sample text message")
+
+// The encrypted message looks like this
+// Qk3XGN5+Ax38Ig01m4AqaP6Y0b0wYpCXtx59sU23uVLWUU/c7axF7LozDg==
+ Once you have encrypted the content, send it to the API with
+ encrypted: true. This flag tells the Android app to
+ decrypt the message before sending it to the recipient.
+
import HttpSms from "httpsms"
+
+client.messages.postSend({
+ content: encryptedMessage,
+ from: '+18005550199',
+ encrypted: true,
+ to: '+18005550100',
+})
+.then((message) => {
+ console.log(message.id) // log the ID of the sent message
+})+ When your Android phone receives an SMS message, the app encrypts the + message with the encryption key configured on the phone before + delivering it to your webhook endpoint. +
+{
+ "event": "message.phone.received",
+ "data": {
+ "content": "bdmZ7n6JVf/ST+SoNlSaOGUL1DcL5705ETw8GAB4llYBgE9HOOL+Pu/h+w==",
+ "encrypted": true,
+ "from": "+18005550100",
+ "id": "msg_123",
+ "to": "+18005550199"
+ }
+}import HttpSms from "httpsms"
+
+const client = new HttpSms("" /* API Key from https://httpsms.com/settings */)
+
+const encryptedMessage = "bdmZ7n6JVf/ST+SoNlSaOGUL1DcL5705ETw8GAB4llYBgE9HOOL+Pu/h+w=="
+const encryptionkey = "Password123"
+const decryptedMessage = client.cipher.decrypt(encryptionkey, encryptedMessage)
+
+// This is a test text message+ Congratulations, you have successfully configured your Android phone + to send and receive SMS messages with end-to-end encryption. Don't + hesitate to contact us if you face any problems while following this + guide. +
+ ++ You can now program your android phone to forward messages received on + your phone to your server and trigger powerful automations with tools + like Zapier and IFTTT. I created an open source application called + httpSMS that helps you to set this up with ease. +
+ ++ Create an account on the httpSMS web app and copy your API key from + the + settings page. +
+ ++ Download the Android app from + https://github.com/NdoleStudio/httpsms/releases/latest/download/HttpSms.apk + and sign in using your API KEY. +
+ ++ Once installed, the app listens for SMS messages received on your + phone. Configure your webhook URL under the + settings page + so the messages can be delivered to your server. +
+ ++ Congratulations, you have successfully set up SMS forwarding from your + Android phone to a webhook! This powerful automation tool can help you + streamline your business workflow and save you time and effort. You + can also trigger the httpSMS application to send an SMS a simple API. + You can find more information on the documentation page at + https://docs.httpsms.com. Until the next time ✌️ +
+ ++ In Android 15 (Vanilla Ice Cream), the android.permission.SEND_SMS and + android.permission.RECEIVE_SMS permissions are now hard restricted and + cannot be granted via the runtime permissions interface. +
+ ++ Long press the icon of the android app which you want to grant the + permission and select 'App info' +
+ ++ On the App Info page, click on the menu button and select the 'Allow + restricted settings' option +
+ ++ Once you have allowed the restricted settings from step 2 above, You + can navigate to Permissions ➡️ SMS and tap the Allow button to grant + SMS permissions to the android app. +
+ ++ Congratulations, you have successfully configured SMS permissions on + your Android app. Don't hesitate to contact us if you face any + problems while following this guide. +
+ ++ Send personalized SMS messages to multiple phone numbers for less than + $0.002 per SMS message. You can also configure every SMS message in + your Excel spreadsheet so they are unique for each recipient phone + number. +
+ ++ Create an account on + httpsms.com + and copy your API key from the + settings page. +
+ ++ Download the Android app from + https://github.com/NdoleStudio/httpsms/releases/latest/download/HttpSms.apk + and sign in using your API KEY. +
+ ++ Download the httpSMS Excel file template from + https://httpsms.com/templates/httpsms-bulk.xlsx + and edit it with Microsoft Excel, Google Sheets, or any spreadsheet + software. Fill in the FromPhoneNumber, + ToPhoneNumber, and Content columns. +
+ ++ Visit the + Bulk Messages page + and upload your Excel file. +
+ ++ Don't hesitate to contact us if you face any issues sending bulk SMS + messages from your Excel files by following this tutorial. Until the + next time ✌️ +
+ ++ Guides, tutorials, and product updates to help you get the most out of + httpSMS. +
+ ++ Send personalized SMS messages to your users in bulk using your + Android phone. The good news is, you don't have to write a single + piece of code, just upload your CSV file and we will take care of the + rest. +
+ ++ CSV stands for Comma-Separated Values. It is a simple file format + where each row is on a new line and each column is separated by a + comma. CSV files can be opened and edited in tools like Microsoft + Excel, OpenOffice, Google Sheets, or even a plain text editor. +
+ ++ Create an account on + httpsms.com + and copy your API key from the + settings page. +
+ ++ Download the Android app from + https://github.com/NdoleStudio/httpsms/releases/latest/download/HttpSms.apk + and sign in using your API KEY. +
+ ++ Download the httpSMS CSV template from + https://httpsms.com/templates/httpsms-bulk.csv + and edit it with spreadsheet software or a text editor. Fill in the + FromPhoneNumber, ToPhoneNumber, and + Content columns. +
+ ++ Visit the + Bulk Messages page + and upload your CSV file. +
+ ++ Don't hesitate to contact us if you face any issues sending bulk SMS + messages from your CSV files by following this tutorial. Until the + next time ✌️ +
+ ++ In an era dominated by social media, instant messaging apps, and + ever-evolving communication technologies, it's easy to overlook the + humble yet remarkably resilient Short Message Service (SMS). Since its + inception in the 1990s, SMS has stood the test of time, remaining one + of the most widely used and reliable means of mobile communication. + Whether you're a business owner looking to optimize your communication + strategy, a developer seeking to integrate SMS functionality into your + applications, or simply intrigued by the enduring charm of SMS, this + article will explain how to setup your Android phone to send SMS + messages. +
+ ++ Create an account on + httpsms.com + and copy your API key from the + settings page. +
+ ++ Download the Android app from + https://github.com/NdoleStudio/httpsms/releases/latest/download/HttpSms.apk + and sign in using your API KEY. +
+ +import requests
+import json
+
+api_key = "" # Get API Key from https://httpsms.com/settings
+
+url = 'https://api.httpsms.com/v1/messages/send'
+
+headers = {
+ 'x-api-key': api_key,
+ 'Accept': 'application/json',
+ 'Content-Type': 'application/json'
+}
+
+payload = {
+ "content": "This is a sample text message sent via python",
+ "from": "+18005550199", # This is the phone number of your android phone
+ "to": "+18005550100" # This is the recipient phone number
+}
+
+response = requests.post(url, headers=headers, data=json.dumps(payload))
+
+print(json.dumps(response.json(), indent=4))
+ Run the script with python send_sms.py.
+
+ Congratulations, you have successfully configured your android phone
+ to send SMS messages via python. You can now reuse this code to send
+ SMS messages from your python applications. If you are also interested
+ in forwarding incoming SMS from your android phone to your server,
+ checkout our SMS forwarding guide
+
+ Automate sending personalized SMS messages each time a new row is + added to your Google Sheets document using Zapier. You don't need to + write any code to make this happen and you can personalize the SMS + messages which are sent out. +
+ ++ In Zapier, create a new Zap and select Google Sheets as your trigger + app. Choose the New Spreadsheet Row event, then + select the Spreadsheet and the correct Worksheet you want to watch for + new rows. +
+ ++ Add a new action step and select + Webhooks by Zapier as the action app. Choose the + Custom Request event and configure it with the + following values: +
+{
+ "content": "Hi {{1.Name}}, your order is ready for pickup.",
+ "from": "{{1.FromPhoneNumber}}",
+ "to": "{{1.ToPhoneNumber}}"
+}{
+ "x-api-key": "YOUR_API_KEY",
+ "Content-Type": "application/json"
+}+ Publish your zap and you will automatically trigger httpsms to send an + SMS to your customer when ever you add a new row in the google sheet. + Don't hesitate to contact us if you face any issues configuring your + zap to send SMS messages from your Google Sheets by following this + tutorial. Until the next time ✌️ +
+ +
+ Fill in our bulk SMS
+ CSV template
+ or our
+ Excel template
+ and upload it here to send your SMS messages to multiple
+ recipients at once. You can also configure
+
+ Your 10 most recent bulk SMS uploads are shown below, including a + delivery status breakdown for each batch. Click on a row to see + individual messages on the search page. +
++ Monitor the connectivity status of your Android phones. Heartbeats + are sent every 15 minutes when the phone is online. +
++ No heartbeats found. Make sure the httpSMS app is running on your + phone. +
++ ✅Trusted by 23,273+ users who send/receive more than + 500,000 messages per month. +
+
+
+ 
+
+ import HttpSms from 'httpsms'
+
+const client = new HttpSms('' /* Get the API Key from https://httpsms.com/settings */);
+
+client.messages.postSend({
+ content: 'This is a sample text message',
+ from: '+18005550199', // Put the correct phone number here
+ to: '+18005550100', // Put the correct phone number here
+})
+.then((message) => {
+ console.log(message.id); // log the ID of the sent message
+})<?php
+$apiKey = "Get API Key from https://httpsms.com/settings";
+
+$options = array(
+ 'http' => array(
+ 'method' => 'POST',
+ 'content' => json_encode( [
+ 'content' => 'This is a sample text message',
+ 'from' => "+18005550199",
+ 'to' => "+18005550100"
+ ]),
+ 'header'=> "Content-Type: application/json\r\n" .
+ "Accept: application/json\r\n" .
+ "x-api-key: $apiKey\r\n"
+ )
+);
+
+$context = stream_context_create( $options );
+$result = file_get_contents( "https://api.httpsms.com/v1/messages/send", false, $context );
+
+echo $result;import requests
+import json
+
+api_key = "Get API Key from https://httpsms.com/settings"
+
+url = 'https://api.httpsms.com/v1/messages/send'
+
+headers = {
+ 'x-api-key': api_key,
+ 'Accept': 'application/json',
+ 'Content-Type': 'application/json'
+}
+
+payload = {
+ "content": "This is a sample text message",
+ "from": "+18005550199",
+ "to": "+18005550100"
+}
+
+response = requests.post(url, headers=headers, data=json.dumps(payload))
+
+print(json.dumps(response.json(), indent=4))import "github.com/NdoleStudio/httpsms-go"
+
+client := htpsms.New(htpsms.WithAPIKey(/* API Key from https://httpsms.com/settings */))
+
+client.Messages.Send(context.Background(), &httpsms.MessageSendParams{
+ Content: "This is a sample text message",
+ From: "+18005550199",
+ To: "+18005550100",
+})var client = HttpClient.newHttpClient();
+var apiKey = "Get API Key from https://httpsms.com/settings";
+
+var payload = """
+ {
+ "content": "This is a sample text message",
+ "from": "+18005550199",
+ "to": "+18005550100"
+ }
+ """;
+
+var request = HttpRequest.newBuilder()
+ .uri(URI.create("https://api.httpsms.com/v1/messages/send"))
+ .header("accept", "application/json")
+ .header("Content-Type", "application/json")
+ .header("x-api-key", apiKey)
+ .POST(HttpRequest.BodyPublishers.ofString(payload))
+ .build();
+
+var response = client.send(request, HttpResponse.BodyHandlers.ofString());
+System.out.println(response.body());curl --location --request POST 'https://api.httpsms.com/v1/messages/send' \
+--header 'x-api-key: Get API Key from https://httpsms.com/settings' \
+--header 'Content-Type: application/json' \
+--data-raw '{
+ "from": "+18005550199",
+ "to": "+18005550100",
+ "content": "This is a sample text message"
+}'var client = new HttpClient();
+client.DefaultRequestHeaders.Add("x-api-key", ""/* Get API Key from https://httpsms.com/settings */);
+
+var response = await client.PostAsync(
+ "https://api.httpsms.com/v1/messages/send",
+ new StringContent(
+ JsonSerializer.Serialize(new {
+ from = "+18005550199",
+ To = "+18005550100",
+ Content = "This is a sample text message",
+ }),
+ Encoding.UTF8,
+ "application/json"
+ )
+);
+
+Console.WriteLine(await response.Content.ReadAsStringAsync());Monthly
+
+ Yearly
+
+ Try sending and receiving SMS on your hobby websites and + experiments. +
++ $0 +
+No credit card required
+
+
+
+
+
+ Send and receive more SMS messages like a pro with advanced + features. +
++ $10/month +
++ $100/year +
++ or $100 per year +
++ or $8.33 per month +
+
+
+
+
+
+ Send and receive up to {{ planMessages }} SMS messages like a + power user. +
++ ${{ planMonthlyPrice }}/month +
++ ${{ planYearlyPrice }}/year +
++ or ${{ planYearlyPrice }} per year +
++ or ${{ planYearlyMonthlyPrice }} per month +
+
+
+
+
+
+ The httpSMS application works only on Android phones at the + moment since Apple doesn't allow you to install a custom SMS + messaging app. +
++ The httpSMS Android app works from Android 9 (Pie) and above. + So you can install the application on your old Android phone + which you don't use anymore. +
++ We do have packages that allow up to 100,000 SMS messages per + month but you can + send us an email if + you will like to send more messages so we create a custom plan + just for you. +
++ No you cannot. When you send an SMS message using the httpSMS + app it uses your SIM card to send the message so the recipient + will see your phone number as the sender of the SMS. You + cannot use your brand name as the sender ID. +
+
+ Join 23,273+ users who send/receive more than
+
+ 500,000 messages per month
+
+ Create separate API keys for each phone. This allows you to manage + multiple phones independently and securely. +
+
+
Ndole Studio built the httpSMS service as an open source project. This
SERVICE is provided by Ndole Studio and is intended for use as is.
This page is used to inform visitors regarding our policies with the
@@ -17,44 +27,41 @@
Conditions, which are accessible at httpSMS unless otherwise defined
in this Privacy Policy.
+
+
For a better experience, while using our Service, we may require you
to provide us with certain personally identifiable information,
- including but not limited to email,full name. The information that we
+ including but not limited to email, full name. The information that we
request will be retained by us and used as described in this privacy
policy.
+
httpSMS does use third-party services that may collect information
used to identify you. Link to the privacy policy of third-party
- service providers used by httpSMS
+ service providers used by httpSMS:
+
+
We want to inform you that whenever you use our Service, in a case of
an error in the app we collect data and information (through
third-party products) on your phone and computer called Log Data. This
Log Data may include information such as your device Internet Protocol
- (“IP”) address, device name, operating system version, the
+ ('IP') address, device name, operating system version, the
configuration of the app when utilizing our Service, the time and date
of your use of the Service, and other statistics.
+
+
Cookies are files with a small amount of data that are commonly used
as anonymous unique identifiers. These are sent to your browser from
the websites that you visit and are stored on your device's internal
- memory. This Service does not use these “cookies” explicitly. However,
- the app may use third-party code and libraries that use “cookies” to
+ memory. This Service does not use these 'cookies' explicitly. However,
+ the app may use third-party code and libraries that use 'cookies' to
collect information and improve their services. You have the option to
either accept or refuse these cookies and know when a cookie is being
sent to your device. If you choose to refuse our cookies, you may not
be able to use some portions of this Service.
+
+
We may employ third-party companies and individuals due to the
following reasons:
+
We want to inform users of this Service that these third parties have
access to their Personal Information. The reason is to perform the
tasks assigned to them on our behalf. However, they are obligated not
to disclose or use the information for any other purpose.
+
+
We value your trust in providing us your Personal Information, thus we
are striving to use commercially acceptable means of protecting it.
But remember that no method of transmission over the internet, or
method of electronic storage is 100% secure and reliable, and we
cannot guarantee its absolute security.
+
+
This Service may contain links to other sites. If you click on a
third-party link, you will be directed to that site. Note that these
external sites are not operated by us. Therefore, we strongly advise
@@ -133,8 +143,9 @@
over and assume no responsibility for the content, privacy policies,
or practices of any third-party sites or services.
+
+
These Services do not address anyone under the age of 13. We do not
knowingly collect personally identifiable information from children
under 13 years of age. In the case we discover that a child under 13
@@ -143,48 +154,27 @@
that your child has provided us with personal information, please
contact us so that we will be able to do the necessary actions.
+
+
We may update our Privacy Policy from time to time. Thus, you are
advised to review this page periodically for any changes. We will
notify you of any changes by posting the new Privacy Policy on this
page.
This policy is effective as of 2022-10-09
+
+ This policy is effective as of 2022-10-09
+
If you have any questions or suggestions about our Privacy Policy, do
not hesitate to contact us at
- support@httpsms.com.
+ support@httpsms.com.
Privacy Policy
+ Information Collection and Use
-
+ Information Collection and Use
+
+
+
- Log Data
- Log Data
+ Cookies
- Cookies
+ Service Providers
- Service Providers
+
+
- Security
- Security
+ Links to Other Sites
- Links to Other Sites
+ Children’s Privacy
- Children's Privacy
+ Changes to This Privacy Policy
-
+ Changes to This Privacy Policy
+
+ Contact Us
- Contact Us
+
-
-
+ No messages found for "{{ searchQuery }}" +
+
+ Use your API Key in the x-api-key HTTP Header when
+ sending requests to
+ https://api.httpsms.com endpoints.
+
+ Webhooks allow us to send events to your server for example when + the android phone receives an SMS message we can forward the + message to your server. +
+
+ Send and receive SMS messages without leaving your discord server
+ with the httpSMS discord app using the
+ /httpsms command.
+
+ Configure when your phone should send SMS messages. Messages sent + outside the schedule will be queued and sent during the next + active window. +
+
+
By downloading or using the app and using the HTTP SMS service, these
terms will automatically apply to you – you should make sure therefore
- that you read them carefully before using the app. You’re not allowed
+ that you read them carefully before using the app. You're not allowed
to copy or modify the app, any part of the app, or our trademarks in
- any way. You’re not allowed to attempt to extract the source code of
- the app, and you also shouldn’t try to translate the app into other
+ any way. You're not allowed to attempt to extract the source code of
+ the app, and you also shouldn't try to translate the app into other
languages or make derivative versions. The app itself, and all the
trademarks, copyright, database rights, and other intellectual
property rights related to it, still belong to Ndole Studio.
+
Ndole Studio is committed to ensuring that the app is as useful and
efficient as possible. For that reason, we reserve the right to make
changes to the app or to charge for its services, at any time and for
any reason. We will never charge you for the app or its services
- without making it very clear to you exactly what you’re paying for.
+ without making it very clear to you exactly what you're paying for.
+
The HTTP SMS app stores and processes personal data that you have
- provided to us, to provide our Service. It’s your responsibility to
+ provided to us, to provide our Service. It's your responsibility to
keep your phone and access to the app secure. We therefore recommend
that you do not jailbreak or root your phone, which is the process of
removing software restrictions and limitations imposed by the official
operating system of your device. It could make your phone vulnerable
- to malware/viruses/malicious programs, compromise your phone’s
- security features and it could mean that the HTTP SMS app won’t work
+ to malware/viruses/malicious programs, compromise your phone's
+ security features and it could mean that the HTTP SMS app won't work
properly or at all.
+
HTTP SMS does use third-party services that declare their Terms and
Conditions. Link to Terms and Conditions of third-party service
- providers used by the app
+ providers used by the app:
+
You should be aware that there are certain things that Ndole Studio
will not take responsibility for. Certain functions of the app will
require the app to have an active internet connection. The connection
can be Wi-Fi or provided by your mobile network provider, but Ndole
Studio cannot take responsibility for the app not working at full
- functionality if you don’t have access to Wi-Fi, and you don’t have
+ functionality if you don't have access to Wi-Fi, and you don't have
any of your data allowance left.
- If you’re using the app outside of an area with Wi-Fi, you should
+
+ If you're using the app outside of an area with Wi-Fi, you should
remember that the terms of the agreement with your mobile network
provider will still apply. As a result, you may be charged by your
mobile provider for the cost of data for the duration of the
connection while accessing the app, or other third-party charges. In
- using the app, you’re accepting responsibility for any such charges,
+ using the app, you're accepting responsibility for any such charges,
including roaming data charges if you use the app outside of your home
territory (i.e. region or country) without turning off data roaming.
- If you are not the bill payer for the device on which you’re using the
+ If you are not the bill payer for the device on which you're using the
app, please be aware that we assume that you have received permission
from the bill payer for using the app.
+
Along the same lines, Ndole Studio cannot always take responsibility
for the way you use the app i.e. You need to make sure that your
- device stays charged – if it runs out of battery and you can’t turn it
+ device stays charged – if it runs out of battery and you can't turn it
on to avail the Service, Ndole Studio cannot accept responsibility.
- With respect to Ndole Studio’s responsibility for your use of the app,
- when you’re using the app, it’s important to bear in mind that
+
+ With respect to Ndole Studio's responsibility for your use of the app,
+ when you're using the app, it's important to bear in mind that
although we endeavor to ensure that it is updated and correct at all
times, we do rely on third parties to provide information to us so
that we can make it available to you. Ndole Studio accepts no
liability for any loss, direct or indirect, you experience as a result
of relying wholly on this functionality of the app.
+
At some point, we may wish to update the app. The app is currently
- available on Android – the requirements for the system(and for any
+ available on Android – the requirements for the system (and for any
additional systems we decide to extend the availability of the app to)
- may change, and you’ll need to download the updates if you want to
+ may change, and you'll need to download the updates if you want to
keep using the app. Ndole Studio does not promise that it will always
update the app so that it is relevant to you and/or works with the
Android version that you have installed on your device. However, you
promise to always accept updates to the application when offered to
- you, We may also wish to stop providing the app, and may terminate use
+ you. We may also wish to stop providing the app, and may terminate use
of it at any time without giving notice of termination to you. Unless
we tell you otherwise, upon any termination, (a) the rights and
licenses granted to you in these terms will end; (b) you must stop
using the app, and (if needed) delete it from your device.
+
We may update our Terms and Conditions from time to time. Thus, you
are advised to review this page periodically for any changes. We will
notify you of any changes by posting the new Terms and Conditions on
this page.
These terms and conditions are effective as of 2022-10-09
+
+ These terms and conditions are effective as of 2022-10-09
+
If you have any questions or suggestions about our Terms and
Conditions, do not hesitate to contact us at
- support@httpsms.com.
+ support@httpsms.com.
Terms and Conditions
+
+
-
+
+
Changes to This Terms and Conditions
- Contact Us
- Contact Us
+
-
-
+ Don't hesitate to + message us on Discord + if you have any questions +
+- httpSMS is an - open source - application that converts your android phone into an SMS gateway so you - can send and receive SMS messages using a simple HTTP API. -
-- Start sending messages -
-- Install the mobile app on your android phone to start sending messages. - You can also - message us on Discord - to help set things up. -
-- {{ $store.getters.getOwner | phoneCountry }} -
-
-
-
- - Your next bill is for ${{ plan.price }} on - {{ - new Date( - $store.getters.getUser.subscription_renews_at, - ).toLocaleDateString() - }} -
-- You are on the life time plan which costs - ${{ plan.price }} -
-- You will be downgraded to the FREE plan on - {{ - new Date( - $store.getters.getUser.subscription_ends_at, - ).toLocaleDateString() - }} -
-- {{ totalMessages }}/{{ plan.messagesPerMonth }} messages -
-- You will be downgraded to the free plan at the end - of the current billing period on - {{ - new Date( - $store.getters.getUser.subscription_renews_at, - ).toLocaleDateString() - }} -
-5,000 messages monthly
-5,000 messages monthly
-- 100,000 messages monthly -
-
- This is the summary of the sent messages and received messages in
- {{
- $store.getters.getBillingUsage.start_timestamp | billingPeriod
- }}.
-
Messages Sent
-Messages Received
-Total Cost
-- This is a list of your last 10 subscription payments made using - our payment provider - Lemon Squeezy. -
-- Summary of all the sent and received messages in the past 12 - months -
-- {{ postDate }} - • {{ readTime }} -
-- We have added support for end-to-end encryption for SMS messages so - that no one can see the content of the messages you send using httpSMS - except you. -
-- You setup an encryption key which you use to encrypt your messages - before making an API request to httpSMS and you also use the same key - to decrypt the messages you receive from httpSMS via our - webhook events. We are using the - AES 256 - encryption algorithm to encrypt and decrypt the messages. -
-- ⬇️ Download and install - the httpSMS Android app on your phone and set you encryption key under - the App Settings page of the app. -
-- We use the AES-256 encryption algorithm to encrypt the SMS messages. - This algorithm requires a an encryption key which is 256 bits to work - around this, we will hash any encryption key you set on the mobile app - using the sha-256 algorithm so that it will always produce a key which - is 256 bits. -
-- The AES algorithm also has an initialization vector (IV) parameter - which is used to ensure that the same value encrypted multiple times - will not produce the same encrypted value. The IV is 16 bits and it is - appended to the encrypted message before encoding it in base64. -
-- When you use our client libraries it will automatically take care of - encrypting your message so you don't have to deal with creating the - initialization vector and encoding the payload yourself. -
-
-import HttpSms from "httpsms"
-
-const client = new HttpSms("" /* API Key from https://httpsms.com/settings */);
-
-const key = "Password123";
-
-const encryptedMessage = client.cipher.encrypt(key, "This is a sample text message");
-
-// The encrypted message looks like this, note that you will get a different encrypted message when you run this code on your computer
-// Qk3XGN5+Ax38Ig01m4AqaP6Y0b0wYpCXtx59sU23uVLWUU/c7axF7LozDg==
-
-
-
-import "github.com/NdoleStudio/httpsms-go"
-
-client := htpsms.New(htpsms.WithAPIKey(""/* API Key from https://httpsms.com/settings */))
-
-key := "Password123" // use the same key on the Android app
-encryptedMessage := client.Cipher.Encrypt(key, "This is a test text message")
-
-// The encrypted message looks like this, note that you will get a different encrypted message when you run this code on your computer
-// Qk3XGN5+Ax38Ig01m4AqaP6Y0b0wYpCXtx59sU23uVLWUU/c7axF7LozDg==
-
-
-
- After generating the encrypted message payload, you can send it
- directly using the httpSMS API. Make sure to set
- encrypted: true in the JSON request payload so that
- httpSMS knows that the message is encrypted and it will be decoded in
- the Android app before sending to your recipient.
-
-import HttpSms from "httpsms"
-
-client.messages.postSend({
- content: encryptedMessage,
- from: '+18005550199',
- encrypted: true,
- to: '+18005550100',
-})
-.then((message) => {
- console.log(message.id); // log the ID of the sent message
-});
-
-
-import "github.com/NdoleStudio/httpsms-go"
-
-client.Messages.Send(context.Background(), &httpsms.MessageSendParams{
- Content: encryptedMessage,
- From: "+18005550199",
- To: "+18005550100",
- Encrypted: true,
-})
-
-
- - When you make the API request, the message will be decrypted before - sending to the recipient. This is a screenshot of the SMS message - which is sent to the recipient. -
-- When your android phone receives a new message, it will be encrypted - with the encryption Key on your Android phone before it is delivered - to your server's webhook endpoint. You can configure webhooks by - following - this guide. -
-
-import HttpSms from "httpsms"
-
-const client = new HttpSms("" /* API Key from https://httpsms.com/settings */);
-
-// The payload in the webhook HTTP request looks like this
-/*
-{
- "specversion": "1.0",
- "id": "8dca3b0a-446a-4a5d-8d2a-95314926c4ed",
- "source": "/v1/messages/receive",
- "type": "message.phone.received",
- "datacontenttype": "application/json",
- "time": "2024-01-21T12:27:29.1605708Z",
- "data": {
- "message_id": "0681b838-4157-44bb-a4ea-721e40ee7ca7",
- "user_id": "XtABz6zdeFMoBLoltz6SREDvRSh2",
- "owner": "+37253920216",
- "encrypted": true,
- "contact": "+37253920216",
- "timestamp": "2024-01-21T12:27:17.949Z",
- "content": "bdmZ7n6JVf/ST+SoNlSaOGUL1DcL5705ETw8GAB4llYBgE9HOOL+Pu/h+w==",
- "sim": "SIM1"
- }
-}
-*/
-
-const encryptedMessage = "bdmZ7n6JVf/ST+SoNlSaOGUL1DcL5705ETw8GAB4llYBgE9HOOL+Pu/h+w==" // get the encrypted message from the request payload
-const encryptionkey = "Password123" // use the same key on the Android app
-const decryptedMessage = client.cipher.decrypt(encryptionkey, encryptedMessage)
-
-// This is a test text message
-
-
-
-import "github.com/NdoleStudio/httpsms-go"
-
-client := htpsms.New(htpsms.WithAPIKey(/* API Key from https://httpsms.com/settings */))
-
-// The payload in the webhook HTTP request looks like this
-/*
-{
- "specversion": "1.0",
- "id": "8dca3b0a-446a-4a5d-8d2a-95314926c4ed",
- "source": "/v1/messages/receive",
- "type": "message.phone.received",
- "datacontenttype": "application/json",
- "time": "2024-01-21T12:27:29.1605708Z",
- "data": {
- "message_id": "0681b838-4157-44bb-a4ea-721e40ee7ca7",
- "user_id": "XtABz6zdeFMoBLoltz6SREDvRSh2",
- "owner": "+37253920216",
- "encrypted": true,
- "contact": "+37253920216",
- "timestamp": "2024-01-21T12:27:17.949Z",
- "content": "bdmZ7n6JVf/ST+SoNlSaOGUL1DcL5705ETw8GAB4llYBgE9HOOL+Pu/h+w==",
- "sim": "SIM1"
- }
-}
-*/
-
-encryptedMessage = "bdmZ7n6JVf/ST+SoNlSaOGUL1DcL5705ETw8GAB4llYBgE9HOOL+Pu/h+w==" // get the encrypted message from the request payload
-encryptionkey := "Password123" // use the same key on the Android app
-decryptedMessage := client.Cipher.Decrypt(encryptionkey, encryptedMessage)
-
-// This is a test text message
-
-
- - Congratulations, you have successfully configured your Android phone - to send and receive SMS messages with end-to-end encryption. Don't - hesitate to contact us if you face any problems while following this - guide. -
-- {{ postDate }} - • {{ readTime }} -
-
- You can now program your android phone to forward messages received on
- your phone to your server and trigger powerful automations with tools
- like Zapier and IFTTT. I created an open source application called
-
- Create an account on the httpSMS web application and copy your API key
- from the settings page.
-
- Install the
- httpSMS
- android app on your phone and sign in using your API KEY which you
- copied above. This app listens for SMS messages received on your
- android phone.
👉
- https://github.com/NdoleStudio/httpsms/releases/latest/download/HttpSms.apk
-
- Once the application has been installed, it will be listening for SMS
- messages received on the android phone. You can configure the
- application to sent this SMS message to your server URL using a
- webhook. You can configure this URL under the settings page in the
- httpSMS application
-
- Congratulations, you have successfully set up SMS forwarding from your - Android phone to a webhook! This powerful automation tool can help you - streamline your business workflow and save you time and effort. -
-- You can also trigger the httpSMS application to send an SMS a simple - API. You can find more information on the documentation page at - https://docs.httpsms.com -
-Until the next time✌️
-- {{ postDate }} - • {{ readTime }} -
-
- In Android 15 (Vanilla Ice Cream), the
- android.permission.SEND_SMS and
- android.permission.RECEIVE_SMS permissions are now hard
- restricted and cannot be granted
- via the runtime permissions interface.
-
SEND_SMS and
- RECEIVE_SMS permissions will allow an Android app to be
- able to read and send SMS messages on your phone. Make sure you trust
- the application before allowing these permissions.
- - Long press the icon of the android app which you want to grant the - permission and select "App info" -
-
- On the App Info page, click on the menu button
-
- Once you have allowed the restricted settings from step 2 above, You - can navigate to Permissions ➡️ SMS and tap the Allow button to - grant SMS permissions to the android app. -
-- Congratulations, you have successfully configured SMS permissions on - your Android app. Don't hesitate to contact us if you face any - problems while following this guide. -
-- {{ postDate }} - • {{ readTime }} -
-- Send personalized SMS messages to multiple phone numbers for less than - $0.002 per SMS message. You can also configure every SMS - message in your Excel spreadsheet so they are unique for each - recipient phone number. -
-
- Create an account on
-
- ⬇️ Download and install - the httpSMS android app on your phone and sign in using your API KEY - which you copied above. This app listens for SMS messages received on - your android phone. -
-
- Download the
- httpSMS Excel file template
- and edit it with your favorite spreadsheet software e.g Excel, Google
- Sheets, Open Office etc. Fill in the phone number which you registered
- in httpSMS in the FromPhoneNumber column and fill in the
- number of the recipient of the SMS in the
- ToPhoneNumber column. Also add the SMS which you want to
- send in the message in the Content column.
-
FromPhoneNumber from step 2
- above in your Excel file
-
- Visit the
-
- Don't hesitate to - contact us - if you face any issues sending bulk SMS messages from your Excel files - by following this tutorial. -
-Until the next time✌️
-- {{ post.description }} -
-{{ post.authorName }}
-
-
- {{ postDate }} - • {{ readTime }} -
-- Send personalized SMS messages to your users in bulk using your - Android phone. The good news is, you don't have to write a single - piece of code, just upload your CSV file and we will take care of the - rest. -
-
- CSV is an abbreviation for comma-separated values. A CSV file allows
- data to be saved in a table structured format using a comma
- , to separate the various cells of a table and a new line
- to separate the various rows in the table. CSV files can be used with
- any spreadsheet program, such as Microsoft Excel, Open Office Calc, or
- Google Sheets.
-
- Create an account on
-
- ⬇️ Download and install - the httpSMS android app on your phone and sign in using your API KEY - which you copied above. This app listens for SMS messages received on - your android phone. -
-
- Download the
- httpSMS CSV file template
- and edit it with your favorite spreadsheet software e.g Excel, Google
- Sheets or even a text editor like notepad. Fill in the phone number
- which you registered in httpSMS in the
- FromPhoneNumber column and fill in the number of the
- recipient of the SMS in the ToPhoneNumber column. Also
- add the SMS which you want to send in the message in the
- Content column.
-
FromPhoneNumber from step 2
- above in your CSV file
-
- Visit the
-
- Don't hesitate to - contact us - if you face any issues sending bulk SMS messages from your CSV files - by following this tutorial. -
-Until the next time✌️
-- {{ postDate }} - • {{ readTime }} -
-- In an era dominated by social media, instant messaging apps, and - ever-evolving communication technologies, it's easy to overlook the - humble yet remarkably resilient Short Message Service (SMS). Since its - inception in the 1990s, SMS has stood the test of time, remaining one - of the most widely used and reliable means of mobile communication. -
-- Whether you're a business owner looking to optimize your communication - strategy, a developer seeking to integrate SMS functionality into your - applications, or simply intrigued by the enduring charm of SMS, this - article will explain how to setup your Android phone to send SMS - messages. -
-
- Create an account on
-
- ⬇️ Download and install - the httpSMS android app on your phone and sign in using your API KEY - which you copied above. This app listens for SMS messages received on - your android phone. -
-
- Now that you have setup your android phone correctly on httpSMS, you
- can write the python code below in a new file named
- send_sms.py. This code will send and SMS and after
- running the script via your Android phone to the recipient phone
- number specified in the payload.
-
api_key from step 1 and also
- use the correct to and from phone numbers in
- the payload variable.
-
-import requests
-import json
-
-api_key = "" # Get API Key from https://httpsms.com/settings
-
-url = 'https://api.httpsms.com/v1/messages/send'
-
-headers = {
- 'x-api-key': api_key,
- 'Accept': 'application/json',
- 'Content-Type': 'application/json'
-}
-
-payload = {
- "content": "This is a sample text message sent via python",
- "from": "+18005550199", # This is the phone number of your android phone */
- "to": "+18005550100" # This is the recipient phone number */
-}
-
-response = requests.post(url, headers=headers, data=json.dumps(payload))
-
-print(json.dumps(response.json(), indent=4))
-
-
-
- Run the code above with the command
- python send_sms.py and check the phone specified in the
- to field of the payload to verify that the
- message has been received successfully.
-
- Congratulations, you have successfully configured your android phone - to send SMS messages via python. You can now reuse this code to send - SMS messages from your python applications. -
-
- If you are also interested in forwarding incoming SMS from your
- android phone to your server, checkout our
-
Until the next time✌️
-- {{ postDate }} - • {{ readTime }} -
-- Automate sending personalized SMS messages each time a new row is - added to your Google Sheets document using Zapier. You don't need to - write any code to make this happen and you can personalize the SMS - messages which are sent out. -
-- Create a new Zap on Zapier and select Google Sheets as the trigger. - The event name should be "New Spreadsheet Row" if you want to - send an SMS message every time a new row is added to your Google - Sheets document. -
-- On the Zap, select the Spreadsheet which you have on google - drive and make sure to select the correct Worksheet. -
-- An action is what happens after the trigger. In this case, we want to - send an SMS message to the customer who made the purchase. Select - Webhooks By Zapier as the action app and select - Custom Request as the action event. -
-
- On the Action section in Zapier, set the Method to
- Post. Set the URL to
- https://api.httpsms.com/v1/messages/send. Set the `Data
- Pass-Through` to false. In the Data field, add the
- following JSON payload.
-
-
-{
- "content": "Hello [Name]\nThanks for ordering [Product] via our shopify store. Your order will be shipped today!",
- "from": "+18005550199",
- "to": "[ToPhoneNumber]"
-}
-
-
- [Name] variable contains the name of the customer on the
- spreadsheet. [Product] contains the name of the product
- which was bought and [ToPhoneNumber] contains the phone
- number of the customer who made the purchase. You can use your own
- custom message with your own set of variables according to your
- spreadsheet. Change the from field to the phone number
- which you registered on httpsms.com.
-
- On the headers section add a new header called
- x-api-key and the value of this header should be your API
- key on
-
- Also add a new header called Content-Type and the value
- of this header should be application/json
-
- The final configuration of the action should look like the screenshot - below. -
-- Publish your zap and you will automatically trigger httpsms to send an - SMS to your customer when ever you add a new row in the google sheet. - Don't hesitate to - contact us - if you face any issues configuring your zap to send SMS messages from - your Google Sheets by following this tutorial. -
-Until the next time✌️
-
- Fill in our bulk SMS
- CSV template
- or our
- Excel template
- and upload it here to send your SMS messages to multiple
- recipients at once. You can also configure
-
- Your 10 most recent bulk SMS uploads are shown below, including a - delivery status breakdown for each batch. Click on a row to see - individual messages on the search page. -
-- Every 15 minutes, the httpSMS app on your Android phone sends a - heartbeat event to the httpsms API to show that it is alive. The - reason for this is because the Android operating system sometimes - kills an application to save battery - https://dontkillmyapp.com. -
-- If httpSMS doesn't get any heartbeat event in a 1-hour interval, - you will get an email notification about it so you can check if - there is an issue with your Android phone. -
-- The table below shows the last 100 heartbeat events received from - the httpSMS app on your Android phone. -
-- ⚡Trusted by 23,273+ users who send/receive more than - 500,000 messages per month. -
-
-
-
-
-
-import HttpSms from 'httpsms'
-
-const client = new HttpSms('' /* Get the API Key from https://httpsms.com/settings */);
-
-client.messages.postSend({
- content: 'This is a sample text message',
- from: '+18005550199', // Put the correct phone number here
- to: '+18005550100', // Put the correct phone number here
-})
-.then((message) => {
- console.log(message.id); // log the ID of the sent message
-})
-
-
-
-<?php
-$apiKey = "Get API Key from https://httpsms.com/settings";
-
-$options = array(
- 'http' => array(
- 'method' => 'POST',
- 'content' => json_encode( [
- 'content' => 'This is a sample text message',
- 'from' => "+18005550199", // Put the correct phone number here
- 'to' => "+18005550100" // Put the correct phone number here
- ]),
- 'header'=> "Content-Type: application/json\r\n" .
- "Accept: application/json\r\n" .
- "x-api-key: $apiKey\r\n"
- )
-);
-
-$context = stream_context_create( $options );
-$result = file_get_contents( "https://api.httpsms.com/v1/messages/send", false, $context );
-
-echo $result;
-
-
-
-import requests
-import json
-
-api_key = "Get API Key from https://httpsms.com/settings"
-
-url = 'https://api.httpsms.com/v1/messages/send'
-
-headers = {
- 'x-api-key': api_key,
- 'Accept': 'application/json',
- 'Content-Type': 'application/json'
-}
-
-payload = {
- "content": "This is a sample text message",
- "from": "+18005550199",
- "to": "+18005550100"
-}
-
-response = requests.post(url, headers=headers, data=json.dumps(payload))
-
-print(json.dumps(response.json(), indent=4))
-
-
-
-import "github.com/NdoleStudio/httpsms-go"
-
-client := htpsms.New(htpsms.WithAPIKey(/* API Key from https://httpsms.com/settings */))
-
-client.Messages.Send(context.Background(), &httpsms.MessageSendParams{
- Content: "This is a sample text message",
- From: "+18005550199",
- To: "+18005550100",
-})
-
-
-
-var client = HttpClient.newHttpClient();
-var apiKey = "Get API Key from https://httpsms.com/settings";
-
-var payload = """
- {
- "content": "This is a sample text message",
- "from": "+18005550199",
- "to": "+18005550100"
- }
- """;
-
-var request = HttpRequest.newBuilder()
- .uri(URI.create("https://api.httpsms.com/v1/messages/send"))
- .header("accept", "application/json")
- .header("Content-Type", "application/json")
- .header("x-api-key", apiKey)
- .POST(HttpRequest.BodyPublishers.ofString(payload))
- .build();
-
-var response = client.send(request, HttpResponse.BodyHandlers.ofString());
-System.out.println(response.body());
-
-
-
-curl --location --request POST 'https://api.httpsms.com/v1/messages/send' \
---header 'x-api-key: Get API Key from https://httpsms.com/settings' \
---header 'Content-Type: application/json' \
---data-raw '{
- "from": "+18005550199",
- "to": "+18005550100",
- "content": "This is a sample text message"
-}'
-
-
-
-var client = new HttpClient();
-client.DefaultRequestHeaders.Add("x-api-key", ""/* Get API Key from https://httpsms.com/settings */);
-
-var response = await client.PostAsync(
- "https://api.httpsms.com/v1/messages/send",
- new StringContent(
- JsonSerializer.Serialize(new {
- from = "+18005550199",
- To = "+18005550100",
- Content = "This is a sample text message",
- }),
- Encoding.UTF8,
- "application/json"
- )
-);
-
-Console.WriteLine(await response.Content.ReadAsStringAsync());
-
-
- Monthly
-
- Yearly
-
- Try sending and receiving SMS on your hobby websites and - experiments. -
-- $0 -
-No credit card required
-
-
-
-
-
- Send and receive more SMS messages like a pro with advanced - features. -
-- $10/month -
-- $100/year -
-- or $100 per year -
-- or $8.33 per month -
-
-
-
-
-
- Send and receive up to {{ planMessages }} SMS messages like a - power user. -
-- ${{ planMonthlyPrice }}/month -
-- ${{ planYearlyPrice }}/year -
-- or ${{ planYearlyPrice }} per year -
-- or ${{ planYearlyMonthlyPrice }} per month -
-
-
-
-
-
Joysankar M.
-- "httpSMS is free platform which transforms your phone into an - sms server! It has no hard limit also. It is an - innovative idea, I have not seen such tech before. If you - have an sms active pack in your phone then good to go - with httpSMS." -
-Edmund Ciego
-- "Outstanding product. Literally have been using this for - years since we don't have an sms gateways that can handle http - requests costing less than 50 cent per sms in my Country. - Love the product and the support! Great work Arnold!" -
-- The httpSMS application works only on Android phones at the - moment since Apple doesn't allow you to install a custom SMS - messaging app. -
-- The httpSMS Android app works from Android 9 (Pie) and above. - So you can install the application on your old Android phone - which you don't use anymore. -
-- We do have packages that allow up to 100,000 SMS messages per - month but you can can - send us an email if - you will like to send more messages so we create a custom plan - just for you. -
-- No you cannot. When you send an SMS message using the httpSMS - app it uses your SIM card to send the message so the recipient - will see your phone number as the sender of the SMS. You - cannot use your brand name as the sender ID. -
-
- Join 23,273+ users who send/receive more than
-
- 500,000 messages per month
-
- If you have multiple phones, you can create a unique phone API
- keys for your different Android phones. These API keys can only be
- used on the specific mobile phone when it calls the httpSMS server
- for specific actions like sending heartbeats, registering received
- messages, delivery reports etc. If you want to interact with the
- full
- httpSMS API, use the API key under your account settings page instead
-
{{ activePhoneApiKey?.name }} API Key?
- {{ activePhoneNumber | phoneNumber }} from your phone API
- key. You will have to logout and login again on the
- httpSMS Android app on the phone which is currently using this
- API key.
- - On this page, you can search all your messages by phone number, - message type, and message status and even using the content of the - SMS message. You will also be able to bulk delete messages and - even export your messages in a CSV file. -
-{{ props.item.content }}
-
-
- Use your API Key in the x-api-key HTTP Header when
- sending requests to
- https://api.httpsms.com endpoints.
-
- Webhooks allow us to send events to your server for example when - the android phone receives an SMS message we can forward the - message to your server. -
-
- Send and receive SMS messages without leaving your discord server
- with the httpSMS discord app using the
- /httpsms command.
-
- List of mobile phones which are registered for sending and - receiving SMS messages. -
-- Create availability schedules and attach them to each phone. - Outgoing messages sent outside the schedule window are queued and - delivered when the schedule opens according to your - configured send rate. -
-- Manage the email notifications which you receive from httpSMS. - Feel free to turn on/off individual notifications anytime so you - don't get overloaded with emails -
-
- Your messages are permanently deleted once they exceed the max
- retention period below, counted from when the message was sent or
- received. You can always delete your messages manually on the
-
- You cannot delete your account because you have an active
- subscription on httpSMS.
-
- You can delete all your data on httpSMS by clicking the button - below. This action is irreversible and all your data will - be permanently deleted from the httpSMS database instantly and it - cannot be recovered. -
-- Click the button below to add the httpSMS bot to your discord - server. You need to do this so we can have permission to send - and receive messages on your discord server. -
-- Don't hesitate to - message us on Discord - if you have any questions -
-