Zum Hauptinhalt springen

YunPian SMS connector

The official Logto connector for YunPian SMS service.

tipp:

This guide assumes you have basic understanding of Logto Connectors. For those unfamiliar, please refer to the Connectors guide to get started.

Get started​

YunPian is a communication service provider offering various services including SMS. The YunPian SMS Connector is a plugin provided by the Logto team to integrate with YunPian's SMS service, enabling Logto end-users to register and sign in via SMS verification codes.

Set up SMS service in YunPian Console​

Create a YunPian account​

Visit YunPian's website to register an account and complete real-name verification.

Get API KEY​

  1. Log in to YunPian Console
  2. Go to "Account Settings" -> "Sub-account Management"
  3. Find and copy the API KEY

Configure SMS templates​

  1. In YunPian Console, go to "Domestic SMS" -> "Signature Filing"
  2. Create and submit a signature, wait for carrier approval
  3. Go to "Domestic SMS" -> "Template Filing" and select "Verification Code"
  4. Create a verification code template, ensure it includes the #code# variable (you can also use "Common Templates" to speed up the approval process)
  5. Wait for template approval
  6. If you need to send international SMS, repeat the above steps but select "International SMS" -> "Template Filing"

Configure in Logto​

  1. In Logto Console, go to "Connectors"
  2. Find and click "YunPian SMS Service"
  3. Fill in the configuration form:
    • API KEY: The API KEY obtained from YunPian
    • SMS templates: Configure templates according to usage, ensure they match exactly with approved templates in YunPian

Notes​

  1. SMS template content must match exactly with the approved template in YunPian
  2. The verification code variable placeholder in YunPian templates is #code#, while in the connector configuration it's {{code}}
  3. YunPian automatically adds the default signature based on API KEY, no need to include signature in the template content
  4. It's recommended to test the configuration before formal use

References​