Phones: pair an Android phone and choose which SIMs send
Echo sends through phones and numbers you own. Pair an Android phone with the Echo app in one scan.
- Install the Echo app on the Android phone.
- In the console, open Devices and choose Connect a phone.
- Scan the QR code with the Echo app.
- Allow the permissions the app asks for (SMS and phone).
- The phone appears online. You can send right away.
- Keep the phone charged and on Wi-Fi or mobile data; Echo shows it online in the console.
- Each SIM keeps the site's daily caps (100 SMS and 100 calls a day by default), so your lines stay within your carriers' rules.
- With several phones, an app chooses which of them send for it, and Echo shares the work between them: equally by default, or by priority.
- Received SMS on a paired phone reach your server as echo.message.received.
GET /v1/echo/devicesWhich devices an app uses
Devices only connect, keep their caps, plans, profiles and health. Which of them send for an app is set per app and per method (SMS, WhatsApp, email, phone call, missed call), in Apps, Methods and devices.
- Equal distribution (the default): each send goes to the chosen device that has sent the least today, so they take turns and end the day level.
- Manual priorities: each send is a lottery weighted by priority from 1 to 10; a higher priority wins more often, never every time.
- A device that cannot send (offline, at its daily cap, no allowance left) is skipped; the lottery or the turns go on with the others.
- A method can be turned off for verification codes, and each method says whether Echo devices may help when none of the chosen devices can.
The same device again
A message, a code or a call to a number or an address goes first from the device (WhatsApp number, SIM, mailbox) that talked to that person most recently, before the app's priorities or its equal sharing; a device the app did not choose or one that cannot send at that moment is never used for it. Turn it off per kind of device on the Devices page. The lookup's answer says where the next send would go (next_send).
For WhatsApp, Echo keeps the conversation as WhatsApp itself has it, not only what Echo sent: messages sent from the phone or another linked device, conversations the person started, and what happened before the number was linked (from WhatsApp's own chat list, when the number comes online and every 30 minutes). A person who wrote in the last 72 hours, or whom the number already wrote to today from anywhere, is not a new conversation. These messages never count toward Echo's daily limits. The lookup shows them as last_in_at and last_out_at under whatsapp.
Which of my devices talked to a number
Give a number or an email address: the answer lists each of your devices that wrote to it or heard from it, with counts and the last time (per SIM for phones), and for a WhatsApp number whether the conversation is open (the person wrote in the last 72 hours).
GET /v1/echo/contacts/lookup