General


What is Wassenger?

Wassenger is a hosted cloud solution for sending automated or semi-automated WhatsApp messages via web and REST API.


Is Wassenger an official product?

No. Wassenger is an independently running service not endorse or related to WhatsApp and Facebook.


How can I use Wassenger for?

Wassenger was created to be a cheap and simple cloud API messaging gateway solution, similar to what a SMS gateway API could be, but from 5 to 30 times cheaper and more powerful.


Can I use Wassenger to process incoming messages from users?

Yes.

You can purchase any I/O product plan and enjoy incoming & outgoing message processing.


Can I run Wassenger technology on my server?

Yes, you can. We have a solution for on-prem software installations offering multiple packages.

Learn more details here.


Can I use Wassenger for massive marketing messages?

We encourage our customers to do not send unsolicited (spam) messages.

That being said, you can technically do it, however, please bear in mind that we are not responsible of the abussive usage that violates WhatsApp terms that might eventually ban your WhatsApp account(s).

Our system is designed to minimize risk from getting automatically banned by WhatsApp when sending massive messages, but there is an inherit risk that we cannot control when users report you as an spammer.

If you send too many unsolicited messages to random users, your account might be banned after a while, since users can manually report your account to WhatsApp as spammer. Eventually, if this is reported across users, this may cause your account getting banned.

We strongly encourage our customers to send legit messages that users are reasonbly expecting to receive. Otherwise, please consider the risk of getting banned and lose your WhatsApp account(s).


Can I use Wassenger for chatbots?

Yes, you can.

Purchase any I/O product plan that would allow you to implement chatbots on top of the API.


How it works?

We remotely communicate with your device running a WhatsApp enabled app associated with a mobile number.

We rely on the WhatsApp protocol in order to establish this communication in real-time and reliable way.


What countries are allowed?

You can register from any country where WhatsApp operates.

As long as you have WhatsApp running in your device, you can use our platform.


Devices


Do I need a physical device in order to send messages?

Yes. This is because messages are delivered through your device. Our platform acts like a proxy API between WhatsApp network and your WhatsApp device account.


What kind of mobile device do I need?

You can use any mobile device that can run WhatsApp. Any mobile operative that supportes WhatsApp is supported.

We recommend a device with at least 1GB of RAM.


Should I have the device permanently connected to Internet?

It's up to you, depending on how much messages do you send and on what times. Our recommendation is to have a dedicated mobile device permanently connected to Internet. If you want to deliver a large volume of messages (+5000 messages per month) at a wide time range, having a dedicated device always online would be the best option.


Can I connect a device that I use as a personal device?

Yes, you can, but we strongly encourage you to do not.

Wassenger systems can arbitrarily try to connect to your device when a new message is waiting for delivery, so your device would consume battery and Internet data (assuming you are connected via 3G/4G connection when you move around).

Also, if you are moving around, it is likely that you gonna lose Internet connection somehow, in which case we cannot deliver any message.

Our recommendation is to use a dedicated device permantently connected to Internet via Wi-Fi.


What happens if the device is not online?

We will try to communicate with your device. If after several retries we cannot, we will send you an alert via email.

Worth noting that no messages will be lost during the process. All messages will be remain in the queue until the device is online again.


What Internet connection do I need?

There is no strict limit here, but we recommend having at least 3Mbps download / 0.5 Mbps upload speed.

Higher speed means faster messages delivery, especially for potentially large media files (+1MB).


How many devices can I have?

You can have many devices. There is no limit. Our elastic platform can scale as much as needed.

Each device is billed separately as a individual monthly subscription. Payment is per device subscription.

If you have more than 20 devices, billing will be agregated in a single charge once per month.


Can I arbitrarily send messages across multiple devices?

Yes, you can.

When sending messages, you can select the device you want to use when deliverying the message.


Can I customize the image, name and description of the WhatsApp profile?

Yes, you can. But you would need to do it manually from your device.

We will support automatic profile update in the future via API.


Messages


What type of messages can I send?

You can send text, location, text + links, text + location, multimedia and text + multimedia messages.


Can I send messages to group chats?

Yes, you can.

However, not all the plans include group messages feature. Please, see our plan features in order to get more details.


Can I prioritize messages?

Yes, you can.

Messages can be prioritized by using four different priority levels:

  • * low
  • * normal (default)
  • * high
  • * urgent

Please, note that only certain plans allow message priorities. See the pricing table for more details.


Can I schedule messages to be delivered at a certain date or time?

Yes, you can.

Messages can be scheduled to a specific date or time.

Please, note that only certain plans allow message scheduling. See the pricing table for more details.


What type of multimedia files can I send?

Images (jpeg, png, bmp, webp), audio (mp3, ogg), videos & gifs (mp4), documents (pdf, doc, docx, xls, xlsx, epub, txt) and archives (zip, tar, gzip, rar).

Other files not explicitly listed before can be supported as well. Contact us if you have questions.


Can I send messages to any phone number?

Yes, you can. Any phone number, worldwide.

If the phone number is not associated to WhatsApp account and therefore cannot be delivered, we will flag the message as failed.


What is the average delivery time per message?

Our system is capable of deliverying a message in a fraction of second if the paired WhatsApp device is online and available.

Typically, if the device queue is empty and the device is online, it would take 1-2 seconds to deliver the message. It may take a bit longer if you are sending a relatively large media message (e.g: document of 5MB).

However, delivery speed would depend on the device's subscription plan. See pricing plans for more information.


How many messages can I deliver?

It depends on your subscription plan.

Basic, professional and business plans are limited to 3, 6, and 15 messages per minute respectively. Enterprise plan limit is 100 messages per minute. Under an optional scenario running Enterprise plan, you can deliver up 6,000 messages per hour or 130,000-140,000 messages per day per connected WhatsApp device/number.

These rates are for text messages. For media messages, especially with large files (+1MB) delivery speed could be reduced from x2 to x4 times because of media file processing and uploading to WhatsApp servers.


What happens if a target phone number does not have WhatsApp account?

If a target phone number does not an active WhatsApp associated to it, we would flag the message as failed delivery because of a WhatsApp non existant phone number.

You can get more details in the API documentation.


WhatsApp Account


Do I need a business account?

Absolutely not. This is one of our product adventadges.

You can operate with a personal one, as long as the account is operative in your device.

That being said, we encourage our customers running a business to register as a business account in WhatsApp.


Can my phone number or WhatsApp account get banned?

It all depends on how do you use the system: if you send too many unsolicited messages, users may report you as spammer, and your account could be eventually banned by WhatsApp.

The only downside here is that your WhatsApp account would not be valid anymore and your would need to register a new WhatsApp account with a different phone number.

Note this would only happen under scenarios where you are massively sending unsolicited messages to users.

In case of a banned WhatsApp account, our platform would allow you easily update the phone number linked to a device, so you can relatively easyly continue operating.


Can I claim ban responsibilities?

We are not responsible, as stated in the service terms, of any situation or service interruption performed by third-parties, including WhatsApp or Facebook.

Since Wassenger only operates as a bridge between your physical mobile device, your WhatsApp account and the WhatsApp network, we are not responsible of potential abuse cases done by users violating WhatsApp service terms.


API


What kind of API is provided?

Wassenger provides a simple resource-oriented API (also known as REST or RESTful API).

We have designed the API to be easy to use from any programming language or framework, or even from a simple bash/shell script.


What programming languages can I use to send messages?

You can use any programming language you want in order to send messages, such as Python, PHP, JavaScript, Java or even a bash/curl script.

You only need to be send HTTP requests.


Can I upload and store media files via API?

Yes, you can. See the files section API documentation.

Files are uploaded via our API, but they are stored in the linked Google Account Drive storage. By default, you can store up to 1GB of media files.

We clean up expired files from your account every day in order to free unused storage space.

Storage space is freely provided by Google and will not incur in any costs.


Can I send bulk messages?

Technically not. However, you can simply make multiple HTTP requests to our API. Messages will be queued and delivered as soon as possible.

We are planning to introduce a more complete bulk messaging API feature in the future.


What do I need in order to use the API?

Wassenger provides a simple resource-oriented API (also known as REST or RESTful API).

All you need is a programming language or shell script that allows you to send HTTP requests to our servers.

If you need technical help, we can assist you. Please, contact us with your questions.


How to authenticate an API call?

API authentication is done by using API tokens. Tokens are secret and should not be shared publicly.

At HTTP level, you can define the API token wheter as "token" query param or "Token" HTTP request header.

For more details, see the API documentation - Authentication section.


Can I have multiple API tokens?

Yes. You can have up to 50 different API tokens. You can also later revoke them.

Tokens are created from the Web Console.

For more details, see the API documentation - Authentication section.


Can I restrict the use of an API token to a particular device?

Unfortunately not.

Any token has all the permissions to perform any action via API.


Webhooks


What are Webhooks?

Webhooks are automated messages sent from a server to another when something happens via HTTP(S). They have a message payload and are sent to a remote URL server (typically the customer server).

We use Webhooks in order to easily notify about message status and events over time.

For instance, our systems would notify your systems everytime a new messages was succesfully delivered or failed.


How to implement a webhook endpoint?

You only need an HTTP(S) server listening on a IP/port reachable from Internet.

That server needs to accept HTTP POST requests, and subsequently read the HTTP JSON body.

For more details about Webhooks technical details, see the API documentation.


How many webhooks can I have?

You can have up to 5 webhook endpoints, each of them having different URLs.

You can also route certain events to a certain webhook endpoint URL, such as only message success delivery events.


How much time it takes to get notified about an event?

We will notify your webhook endpoints every minute if there are new events pending.

We notify up to 50 events within the same HTTP request payload.


What Webhooks events are supported?

We currently support the following events:

  • * message:in:new - New incoming message
  • * message:out:sent - Message was delivered successfully
  • * message:out:retry - Message delivery failed and will be retried
  • * message:out:failed - Message delivery failed
  • * message:out:expired - Message delivery date expired
  • * message:out:removed - Message was removed before processing
  • * device:status:update - Device status changed


What happens if my webhook endpoint is failing or not accepting events?

Nothing bad. We will retry it for a while.

We treat as failed notification any network originated error (timeout, DNS error, connection reset...) and HTTP response status higher or equal to 400.

Only after several failures in a row, we will deactivate the endpoint and notify you via email.

You can later re-activate the webhooks via API or from the Web Console.


Do I must use webhooks?

Absolutely not. Using Webhooks is totally optional.

If you do not care about getting updates about the messages status, then it is totally fine to ignore them.


Billing


How do I pay?

You can pay via debit or credit card. We currently accept a wide range of brands, including Visa, Mastercard, Maestro...


Are payments secure?

Absolutely. We use Stripe for payments, one of the most solid and secure payment solution in the industry.

Also, we DO NOT store any card information because of privary and law regulations. Everything is exclusively sent and store in Stripe.


How frequent would I be charged?

We charge per device subscription plan on monthly basis (every 28-31 days).

How much can I pay?

This all depends on your how many devices you have and which plan do you need.

Total monthly cost would be the sum of the active device subscription. Each device subscription is billed individually each month.

You can also cancel or create device subscriptions arbitrarily based on your needs.

Can I upgrade or downgrade plans?

Yes. You can upgrade whenever you want. Downgrade is only available after 7 days of current plan.

Billing amount would be prorated per daily basis when a plan changes.

Can I pay more than the plan price?

Yes, only in case that you exceed the plan included limits (messages or media messages).

You can control the device consumption from the Web Console.

We recommend you to upgrade a plan if you think the limits can be exceeded recurrently. It is cheaper that way.


Do price include taxes?

Prices does not include taxes by default.

If you operate in some European Union country and do not have a registered VAT number, we would have to add on top of the given price the proper tax applicable to your home country in the invoice.

This tipically represents from 17% to 27% of additional cost due to taxes, depending on each country.

Countries outside European Union are tax free.


Can I cancel the subscription?

Yes, you can cancel the subscription at anytime.

By default, service will continue operating until the current month billing cycle ends, unless you explicitly remove the contract.


Can I get refund?

We are sorry, our service terms does not include refunds.

We exclusively refund in case of billing error or duplicated charges.