Enviar un código de voz

​

Qué es

​

Antes de empezar

• Activa Voice para tu cuenta de YCloud.
• Recopila el número de teléfono del destinatario en formato E.164.
• Genera un código de 4 a 6 dígitos de corta duración.
• Elige un idioma compatible.
• Decide si el estado llega a través de una URL de devolución de llamada o un Webhook configurado.

​

Cómo funciona

1. Genere y almacene de forma segura el desafío de verificación.
2. Envíe el código a través de la API de voz.
3. Almacene el ID del registro de voz devuelto y su externalId.
4. Reciba actualizaciones de entrega a través del callback o Webhook.
5. Valide el código en su aplicación y caduque el desafío.

​

Solicitud

curl --request POST https://api.ycloud.com/v2/voices \
  --header "X-API-Key: $YCLOUD_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
    "to": "+16315551111",
    "verificationCode": "123456",
    "language": "en",
    "externalId": "login-7f10b6",
    "callbackUrl": "https://example.com/webhooks/voice"
  }'

​

Respuesta

{
  "id": "VOICE_MESSAGE_ID"
}

​

Estado de entrega

​

Proteger el flujo de verificación

• Haga que los códigos expiren rápidamente.
• Limite los intentos de envío y comprobación por usuario, destino, IP y dispositivo.
• Nunca registre el código de verificación.
• Evite que un código se reutilice después de ser aprobado.
• Evite revelar si un número de teléfono pertenece a una cuenta.

​

Límites y solución de problemas

• verificationCode debe contener de 4 a 6 dígitos.
• Los números de teléfono deben usar el formato E.164.
• La disponibilidad de idiomas puede variar según el país o la región.
• Utilice externalId y el ID de registro de YCloud para investigar la entrega.
• Prefiera la Verify API cuando desee que YCloud administre tanto la entrega como la comprobación del código como un único ciclo de vida de verificación.