BlueBubbles Server
  • Server Overview
  • Installation Guides
    • Standard Installation
    • Manual Setup
  • FAQ
  • Private API Setup
  • Supporting the Project
  • Licenses / Legal
  • Basic Guides
    • Basic Guides - Overview
    • Port Forwarding & Dynamic DNS
    • Prevent macOS from Sleeping
    • Migrating Servers
    • Multiple Users on the Same Mac
    • Autostart Server After Crash
  • Troubleshooting Guides
    • Troubleshooting Guides - Overview
    • BlueBubbles Server Cannot Access MacOS Contacts
    • Not Receiving Notifications or URL Changes on Android
    • Unable to Send Messages to International Contacts
    • BlueBubbles App is Taking Up Too Much Storage
    • Can't Send Messages from BlueBubbles
    • BlueBubbles Server Opens to a Blank White Screen
    • Slow Upload Speed When Connecting Over LAN
    • Restarting Your Server Without a Direct Connection
    • Fix FaceTime Features for Virtual Machines
  • Advanced Guides
    • Advanced Guides - Overview
    • Generating an SSL Certificate using CertBot
    • Disabling SIP on Unofficial Macs for the Private API
    • Registering a Phone Number with your iMessage Account
    • macOS Virtualization
      • Running a macOS VM
        • Deploying macOS in VMWare on Windows (Full Guide)
        • Enabling iMessage in a VM
        • External Guides
          • Big Sur VM on a Mac Device
          • Big Sur VM on Proxmox
          • Big Sur VM on AMD Windows
          • Big Sur VM on Intel Windows
          • Catalina VM on a Mac Device
          • Catalina VM on Proxmox
          • Catalina VM on Intel / AMD Windows
          • Catalina VM on Intel Windows
          • Monterey VM on AMD Windows
      • Running BlueBubbles in Docker-OSX
        • Configuring BlueBubbles as a Service
    • BYO Proxy Service Guides
      • Cloudflare with a Custom Domain
      • Caddy & DuckDNS
      • Nginx Proxy Manager
      • Nginx Manual Setup
      • Tailscale VPN Setup
  • Developer Guides
    • Developer Guides - Overview
    • Build Yourself / Contribution Guide
    • REST API & Webhooks
    • Simple Web Server for Webhooks
      • Python Web Server Example
Powered by GitBook
On this page
  • Why are my messages not sending?
  • How can I fix the issue?
  • Best Solution
  • Fallback Solution

Was this helpful?

Edit on GitHub
Export as PDF
  1. Troubleshooting Guides

Unable to Send Messages to International Contacts

This document will guide you on how to fix issues with sending messages to international phone numbers.

Why are my messages not sending?

Typically, when you are having issues sending messages to international phone numbers (non-US), it is due to a missing region code. When the BlueBubbles Server receives a request to send a message, it will do the following:

  1. Checks if the phone number has a region code (i.e. +1 for US numbers)

    • If it does, it will be used to send the message (best case)

  2. If no region code is provided, the BlueBubbles Server will use the region code set by the base macOS system

    • This is the next best option, but not always a sure-fire solution

  3. If no region code is provided and the BlueBubbles Server cannot determine the macOS region, +1 will automatically be applied to the phone number

    • This is likely what is occurring, and why messages are not sent properly

How can I fix the issue?

Best Solution

The best solution to this issue is to make sure that your Contacts on your Android device includes the region code for the country the person is from.

For instance, if the person is from the United Kingdom, make sure the phone number associated with their Contact entry is something like: +44 20 7123 4567

Fallback Solution

The next best option is to set your macOS device's region to the region that the majority of your Contacts reside in.

To do this, open System Preferences and navigate to the Date & Time settings.

Find the Region drop-down, and select your default region

Once you've set it, close System Preferences and then restart the BlueBubbles Server. That's it! The server should now "imply" your default region code if no region code is provided with each phone number.

We still highly advise making sure that your Contacts on your Android device already include a region code.

PreviousNot Receiving Notifications or URL Changes on AndroidNextBlueBubbles App is Taking Up Too Much Storage

Last updated 1 year ago

Was this helpful?