聊天机器人和AI智能体SMS短信API接收指南
您的AI智能体和聊天机器人需要一个能接收Cash App、Coinbase、Tinder、银行应用或任何双因素认证流程中的SMS短信验证码的电话号码。Twilio等VoIP服务会拒绝大多数验证码。这里是如何将聊天机器人或AI智能体连接到MeiSIM的Webhook API，接收真实SMS短信的完整指南。
您的AI智能体和聊天机器人需要一个能接收Cash App、Coinbase、Tinder、银行应用或任何双因素认证流程中的SMS短信验证码的电话号码。Twilio等VoIP服务会拒绝大多数验证码。这里是如何将聊天机器人或AI智能体连接到MeiSIM的Webhook API，接收真实SMS短信的完整指南。
获取API密钥
免费获得5个号码。Webhook交付延迟不到3秒。
工作流程概览
- 您的AI智能体使用Webhook URL调用
POST /v1/numbers/provision接口。 - 约60秒后，您的智能体获得一个真实的美国电话号码（API响应返回eSIM二维码、ICCID和LPA）。
- 智能体使用该号码在Cash App、Coinbase等服务中注册。
- 注册服务向该号码发送SMS短信验证码。
- MeiSIM通过运营商网络接收SMS短信（约1秒）。
- MeiSIM以POST请求发送短信到您的Webhook URL（再加1-2秒）。
- 您的AI智能体读取短信内容，提取验证码，完成注册。
Webhook合约和数据格式
MeiSIM向您的URL POST一个JSON请求体。您需要在10秒内返回HTTP 200状态码以确认接收。如果失败或超时，我们会进行指数退避重试：立即重试、加15秒、加60秒、加300秒——总共4次尝试，覆盖6分钟。消息也可以通过消息端点查询，保留30天。
轮询模式（Webhook不可用时的备选方案）
如果您更倾向于轮询而不是维护一个Webhook端点（这对于无状态AI智能体很常见），可以调用：
大多数AI智能体在等待验证码时每2-3秒轮询一次。SMS验证码通常在30秒内到达；失败的尝试可能需要5分钟才能重新发起。轮询模式适合无法维护公网Webhook的离线环境或内网部署。
自动提取验证码（OTP代码）
不同服务的短信内容格式不同，但验证码总是4-8位数字。大多数AI智能体使用正则表达式如 /\b\d{4,8}\b/ 提取验证码。为了获得更高的可靠性和准确性，可以让LLM（如Claude或GPT-4o）读取短信文本并直接返回数字验证码——这个过程仅需毫秒级时间。
认证和安全
每个Webhook POST都使用HMAC-SHA256进行签名。通过您的API密钥验证 X-MeiSIM-Signature 请求头，确保请求确实来自MeiSIM而不是伪造者。详细代码示例请参考 API文档。API密钥应存储在环境变量中，永远不要在代码或日志中硬编码。
支持的应用和服务
MeiSIM SMS API支持以下主流应用的短信验证码接收：
- 支付和转账：Cash App、PayPal、Stripe、Wise、Revolut、Square Cash、Google Pay、Apple Pay、支付宝、微信支付
- 加密货币交易：Coinbase、Kraken、Binance.US、Gemini、Robinhood、OKX、Bybit
- 约会应用：Tinder、Bumble、Hinge、Match、OkCupid、Badoo
- 社交媒体：Discord、WhatsApp Business、Telegram、WeChat、小红书、Instagram、TikTok、Facebook、Twitter/X
- 电商平台：Amazon Seller Central、eBay、Etsy、Walmart Marketplace、Shopify、Mercari、Poshmark、沃尔玛、亚马逊
- 出行和外卖：Uber、Lyft、DoorDash、Instacart、Uber Eats、Grubhub、饿了么、美团外卖
- 流媒体和区域限制内容：Netflix US、Hulu、Disney+ US、Peacock、HBO Max US、Paramount+、Amazon Prime Video
- 银行和金融：Chime、Mercury、Brex、美国银行账户开户、ITIN申请、信用卡申请
- 应用商店：Apple App Store US、Google Play US、Steam US
今晚就开始构建
API密钥 + 前5个号码完全免费。发邮件给我们，我们会为您设置。
常见问题（FAQ）
SMS短信到达我的Webhook需要多长时间？
中位延迟不到3秒。在失败时进行指数退避重试。消息保存30天供轮询使用。运营商网络接收约1秒，MeiSIM处理和POST到您的Webhook再需1-2秒，总计通常在3秒以内。
我不想使用Webhook，能只用轮询吗？
可以。调用 GET /v1/numbers/{id}/messages，可选参数 since_iso 用于获取特定时间戳之后的消息。大多数AI智能体在验证码等待期间每2-3秒轮询一次。轮询模式完全免费，不需要维护公网Webhook端点。
能接收来自短码（5位数字号码）的验证码吗？
能。来自美国银行、约会应用、加密货币交易所的验证码通常通过短码发送。这正是我们使用真实运营商号码的主要原因——VoIP服务会拦截这些短码验证，而真实号码则不会。
支持MMS（带图片的多媒体消息）吗？
目前仅支持SMS短信。MMS功能已列入开发路线图，预计在未来版本中推出。
一个号码支持多个Webhook吗？
一个号码只能配置一个Webhook。如果需要多个接收端点，可以通过您自己的分发服务进行转发。
SMS API支持哪些验证应用？
支持全球主流应用包括Cash App、PayPal、Stripe、Coinbase、Kraken、Tinder、Bumble、Amazon、eBay、Uber、DoorDash、Discord、Telegram、WeChat、支付宝和许多其他需要SMS验证码的服务。
API响应时间和号码激活需要多长时间？
号码分配通常在30-60秒内完成。API立即返回eSIM二维码和ICCID，随后您可以激活号码。SMS到Webhook的中位延迟在3秒以内，轮询模式的延迟取决于轮询频率。
能否接收国际短信或非美国号码发送的验证码？
美国号码主要接收来自美国应用和服务的验证码。如需国际验证码接收或其他地理覆盖，请联系我们的技术支持团队了解扩展选项。
短信消息在系统中保留多久？
所有SMS消息在我们的服务器上保留30天。您可以随时通过轮询接口查询历史消息，即使您的Webhook端点在当时不可用。
如何验证Webhook请求确实来自MeiSIM？
每个Webhook POST都使用HMAC-SHA256进行签名。通过您的API密钥验证 X-MeiSIM-Signature 请求头中的签名，这样可以防止未授权的欺骗攻击。详见API文档中的安全部分。
一个API密钥可以管理多少个号码？
单个API密钥可以管理无限数量的号码。您可以根据需要随时添加或删除号码。所有号码共享相同的API端点和认证机制。
Webhook超时或失败如何处理？
如果您的Webhook在10秒内没有返回HTTP 200，MeiSIM将进行4次重试：立即、15秒后、60秒后和300秒后。如果所有重试都失败，消息仍会保留30天供您通过轮询接口查询。
聊天机器人如何自动提取验证码？
使用正则表达式如 /\b\d{4,8}\b/ 提取4-8位数字验证码。为了获得更高可靠性，可以让LLM（如Claude或GPT-4o）读取短信文本并直接返回验证码，处理耗时仅毫秒级。
MeiSIM SMS API和其他服务（如Twilio）有什么区别？
MeiSIM提供真实美国运营商号码（不是VoIP），可以接收短码验证码。短码验证通常被Twilio等VoIP服务拦截。我们针对AI智能体和聊天机器人优化，提供Webhook和轮询双重模式，延迟仅3秒。
支持的编程语言和框架有哪些？
MeiSIM API基于标准REST接口，支持所有编程语言。我们提供Python、JavaScript/Node.js、Go、Java的SDK示例代码。您也可以直接使用HTTP客户端库集成。
如何在不暴露API密钥的情况下安全使用API？
将API密钥存储在环境变量或密钥管理服务中，不要提交到版本控制系统。使用服务端API调用而不是前端，确保API密钥永不暴露给客户端。每个Webhook POST都包含HMAC签名，验证签名可进一步防止未授权访问。