项目邀请联系人功能：验证手机号是否绑定WhatsApp

原代码的局限性 #

你当前用canLaunchUrl的判断逻辑存在明显缺陷：它仅检查设备能否打开指定URL，无法准确判断手机号是否真的注册了WhatsApp。比如设备未安装WhatsApp时，即便号码已注册，也会被误判为非WhatsApp账号；另外，手机号格式不规范（比如缺少国家代码、带特殊符号）也会导致判断失效。

一、先规范手机号格式 #

WhatsApp要求号码必须为国际标准格式（带国家代码，无任何非数字字符），这是后续验证的基础：

// 格式化手机号为国际标准格式（示例默认中国区号+86，可根据用户地区动态调整）
String formatPhoneNumber(String phoneNumber) {
  // 移除所有非数字字符
  final cleaned = phoneNumber.replaceAll(RegExp(r'\D'), '');
  // 补全国家代码
  if (cleaned.startsWith('86')) {
    return '+$cleaned';
  } else if (!cleaned.startsWith('+')) {
    return '+86$cleaned';
  }
  return cleaned;
}

二、官方API验证（最准确方案） #

WhatsApp Business Platform提供了官方验证接口，可直接查询手机号是否注册了WhatsApp。需要先申请WhatsApp商业账号并获取API密钥：

import 'package:http/http.dart' as http;
import 'dart:convert';

Future<bool> checkWhatsAppRegistration(String formattedPhone) async {
  const apiKey = '你的WhatsApp API密钥';
  const businessId = '你的商业账号ID';

  final response = await http.get(
    Uri.parse('https://graph.facebook.com/v18.0/$businessId/phone_numbers?phone=$formattedPhone'),
    headers: {'Authorization': 'Bearer $apiKey'},
  );

  if (response.statusCode == 200) {
    final data = json.decode(response.body);
    // 接口返回非空数据则代表号码已注册
    return data['data'] != null && data['data'].isNotEmpty;
  } else {
    // 请求失败时，降级到本地判断逻辑
    return await _localWhatsAppCheck(formattedPhone);
  }
}

// 本地降级判断逻辑
Future<bool> _localWhatsAppCheck(String formattedPhone) async {
  final url = Uri.parse('https://wa.me/$formattedPhone');
  return await canLaunchUrl(url);
}

三、无API权限时的优化本地方案 #

如果暂时无法使用官方API，可通过以下方式降低误判率：

1. 先检查设备是否安装了WhatsApp
2. 再用规范后的号码调用canLaunchUrl

import 'package:device_apps/device_apps.dart';

// 检查设备是否安装WhatsApp
Future<bool> isWhatsAppInstalled() async {
  return await DeviceApps.isAppInstalled('com.whatsapp');
}

// 优化后的本地验证逻辑
Future<bool> isPhoneOnWhatsApp(String phoneNumber) async {
  final formattedPhone = formatPhoneNumber(phoneNumber);
  final hasWhatsApp = await isWhatsAppInstalled();
  
  if (!hasWhatsApp) {
    // 设备未装WhatsApp，直接返回false（或提示用户安装）
    return false;
  }
  
  final url = Uri.parse('https://wa.me/$formattedPhone');
  return await canLaunchUrl(url);
}

四、按钮切换逻辑 #

在UI层根据验证结果动态显示对应按钮：

// 假设已获取选中的手机号selectedPhone
final isWhatsAppUser = await isPhoneOnWhatsApp(selectedPhone);

// 渲染按钮
isWhatsAppUser 
    ? ElevatedButton(
        onPressed: () => _openWhatsApp(selectedPhone),
        child: const Text('WhatsApp邀请'),
      )
    : ElevatedButton(
        onPressed: () => _sendInviteSMS(selectedPhone),
        child: const Text('短信邀请'),
      );

内容的提问来源于stack exchange，提问作者Vijay