Skip to content

FAQ - Webhooks ❓

The sms:received webhook is not triggering

If your SMS-received webhook isn't firing, try these solutions:

  1. RCS Interference 

    - RCS messages don't trigger SMS webhooks
+ Fix: Disable RCS in Google Messages
    Steps:

    • Install Google Messages
    • Set as default SMS app
    • Go to Settings → RCS Chats → Disable

  2. Third-Party App Issues 

    - Some third-party messaging apps may interfere with SMS event broadcasting.
+ Fix: Use the device's default messaging app or Google Messages

  3. Permission Check
    Verify that the app has the necessary permissions

    • SMS permission granted
    • Not battery optimized
    • Background activity allowed

Can I use webhooks with an HTTP server without encryption?

Due to Android OS restrictions and app policy, webhook events can only be received through an encrypted HTTPS connection.

Exceptions

  • Loopback IP address 127.0.0.1 in Local mode can be used without encryption.

Private IPs

Use Project CA to issue a valid certificate for private IP addresses.

How to use webhooks with self-signed certificate?

Support for user-provided self-signed certificates will be removed in version 2.x of the app. It is strongly recommended to use the project's CA for generating certificates instead.

Migration

  1. Update the app to the latest version
  2. Generate Webhook cert
  3. Update server config to use the new cert
  4. Remove self-signed certs from the device

How to use webhooks without internet access?

By default, webhooks require internet access and will wait until it's available to improve deliverability. However, if you're using the app in an isolated environment without internet access, you can disable this requirement. Here's how:

  1. Open app → Settings tab
  2. Navigate to Webhooks section
  3. Toggle off "Require Internet connection"

Tradeoff

Disabling internet access requirement may affect the reliability of webhook delivery for external endpoints

Still Having Issues?

Visit our Support Forum or contact us at [email protected]

Include these details:

  • App version
  • Android version
  • Full webhook configuration