@byteowls/capacitor-sms

Capacitor SMS plugin

Plugin for sending short messages using the device's SMS app.

Installation

For Capacitor v5

npm i @byteowls/capacitor-sms
npx cap sync

For Capacitor v4

npm i @byteowls/capacitor-sms@4
npx cap sync

For Capacitor v3

npm i @byteowls/capacitor-sms@3
npx cap sync

Versions

Plugin	For Capacitor	Docs	Notes
5.x	5.x.x	README	Breaking changes see Changelog.
4.x	4.x.x	README	Breaking changes see Changelog.
3.x	3.x.x	README	Breaking changes see Changelog. XCode 12.0 needs this version
2.x	2.x.x	README	Breaking changes see Changelog. XCode 11.4 needs this version
1.x	1.x.x	README

Sponsors

I would like to especially thank some people and companies for supporting my work on this plugin and therefore improving it for everybody.

Maintainers

Maintainer	GitHub	Consulting
Michael Oberwasserlechner	moberwasserlechner	https://byteowls.com

Configuration

Starting with version 3.0.0, the plugin is registered automatically on all platforms.

This plugin always uses the default sms app.

Use it

import {Component, OnInit} from '@angular/core';
import {SmsManager} from "@byteowls/capacitor-sms";


@Component({
    template: "<button mat-raised-button color='primary' (click)='sendSms()'>Send SMS now!</button>"
})
export class SmsExampleComponent implements OnInit {

    async ngOnInit() {
        const info: DeviceInfo = await Device.getInfo();
    }

    sendSms() {
        const numbers: string[] = ["[phone]", "[phone]"];
        SmsManager.send({
            numbers: numbers,
            text: "This is a example SMS",
        }).then(() => {
            // success
        }).catch(error => {
            console.error(error);
        });
    }
}

Error Codes

• SEND_CANCELLED ... User cancelled or closed the SMS app.
• ERR_SEND_FAILED ... The SMS app returned that sending the message to the recipients failed. (ios only)
• ERR_SEND_UNKNOWN_STATE ... The SMS app returned a unknown state. There is nothing I can do to clarify the error. (ios only)
• UNIMPLEMENTED ... Sending SMS on the web is not supported.
• ERR_NO_NUMBERS ... No recipient numbers were retrieved from options. Make sure to deliver only valid numbers, because the whole sending will fail.
• ERR_NO_TEXT ... No message text was retrieved from options.
• ERR_SERVICE_NOTFOUND ... The used device can not send SMS.

Platform: Android

Prerequisite: Capacitor Android Docs

Register plugin

On Android the plugin is registered automatically by Capacitor.

Platform: iOS

Register plugin

On iOS the plugin is registered automatically by Capacitor.

Platform: Web/PWA

• Not supported.

Platform: Electron

• Not supported.

Contribute

See Contribution Guidelines.

Changelog

See CHANGELOG.

License

MIT. Please see LICENSE.

Disclaimer

We have no business relation to Ionic.