SMS

¿Cómo recopilo consentimientos de SMS?

Recopila consentimientos de SMS explicando qué enviarás, pidiendo a la persona que acepte y conservando la evidencia de ese acuerdo.

Un número de teléfono ingresado en el proceso de compra puede estar destinado a actualizaciones de envío. Agregar ese número a una campaña promocional requiere un permiso que cubra esos mensajes.

¿Qué permiso necesita mi programa?

Los mensajes promocionales necesitan permiso para promociones. Una solicitud de actualizaciones de servicio cubre ese propósito informativo.

Los principios de mensajería de CTIA establecen las expectativas de la industria para la mensajería comercial en EE. UU. El Anexo II requiere permiso por escrito para promociones. Los mensajes informativos necesitan permiso expreso. Una respuesta relevante a una conversación iniciada por el cliente no necesita permiso adicional según esa guía.

Agregar una oferta puede convertir un recordatorio en una promoción. CTIA da este ejemplo:

Adding a call-to-action (e.g., a coupon code to an informational text) may place the message in the promotional category.

Elige tu contenido antes de recopilar el permiso, para que la invitación cubra los mensajes que realmente envías. Aplica los requisitos legales del destino junto con la guía de la industria. Consentimiento expreso por escrito explica la definición legal en EE. UU.

¿Qué debe indicar la invitación a la persona?

Muestra quién enviará, qué enviará y cómo puede la persona detenerlo.

La sección 5.1.1 de CTIA solicita el programa, la identidad y número del remitente, tarifas, instrucciones de exclusión, detalles de ayuda y los términos aplicables. Mantén esas divulgaciones visibles junto a la acción que registra el acuerdo. Un anuncio con palabra clave también necesita divulgaciones.

Para mensajes recurrentes, explica la frecuencia. Envía una confirmación de inscripción con detalles de exclusión y soporte. La sección 5.1.2.1 describe esa confirmación.

Deja que la persona realice la acción de aceptación por sí misma. No preselecciones su aceptación ni la ocultes dentro de términos no relacionados, porque ninguna de las dos opciones establece una decisión informada sobre tus mensajes.

¿Qué evidencia debo conservar?

Conserva la hora de consentimiento, la identidad y el número de la persona, y la invitación que aceptó.

La sección 5.1.2 de CTIA también menciona el método de recopilación, la campaña y la dirección IP cuando corresponda. Guarda el texto y la acción usada para aceptar. Una marca de tiempo por sí sola no puede demostrar si la persona aceptó recordatorios o promociones.

Si tu programa requiere doble consentimiento, pide a la persona que confirme desde su teléfono antes de considerar la inscripción como completa. Modelos de consentimiento de SMS explica ese paso adicional.

¿Cómo registro el consentimiento en Bird?

Registras la decisión a través de POST /v1/preferences. Conserva la evidencia de respaldo en tu propio sistema.

Configura channel como sms y handle con el número de teléfono incluido su código de país, por ejemplo +15550001234. Configura status como granted o revoked.

  • consented_at registra cuándo aceptó la persona. Una concesión sobre una exclusión almacenada necesita una marca de tiempo posterior. No puede estar en el futuro.
  • source identifica el formulario, la campaña o el lote de importación. Acepta de 1 a 255 caracteres, así que usa una referencia breve a tu evidencia.
  • coverage acepta non_transactional o all. El valor predeterminado, non_transactional, deja los recibos y los códigos de verificación fuera del alcance de esa preferencia.
  • sender_scope limita la declaración a un solo remitente. Omítelo para cobertura de todo el canal dentro del espacio de trabajo.

Bird compara declaraciones para el mismo canal, identificador, alcance de remitente y tema. Un tema agrupa mensajes bajo una suscripción. El campo topic_id de la respuesta identifica ese grupo. Un valor null significa todos los temas.

Una declaración más antigua devuelve applied: false, con la declaración vigente en preference. Verifica ese resultado para que una importación antigua no parezca haber restaurado el permiso.

La exclusión voluntaria de la propia persona tiene mayor protección que una aserción API. No puedes anularla ni eliminarla a través de este API, ni siquiera con una marca de tiempo posterior. El endpoint de preferencias documenta el comportamiento de escritura.

¿Una respuesta START crea el registro de consentimiento inicial?

Una respuesta START finaliza la supresión del remitente. No reemplaza tu recopilación inicial de consentimiento.

La operación start de Bird finaliza esa supresión. Luego envía la confirmación configurada. Un START de alguien que nunca fue suprimido puede recibir una confirmación sin establecer a qué aceptó originalmente.

La operación confirm reconoce respuestas de doble consentimiento. No envía respuesta. Tu controlador debe completar ese flujo. Palabras clave STOP explica el comportamiento separado de palabras clave y supresión.

¿Qué debo verificar antes de enviar?

Envía solo cuando la invitación, la evidencia de consentimiento y el flujo implementado coincidan.

  1. Ajusta el permiso al contenido real del mensaje.
  2. Aplica el modelo de consentimiento del destino.
  3. Conserva la invitación y la hora de consentimiento, y verifica el resultado de escritura de preferencias de Bird.
  4. Completa el intercambio de confirmación si tu programa requiere doble consentimiento.

En resumen

  1. Ajusta el permiso al contenido.

    El permiso para recordatorios no cubre automáticamente los mensajes promocionales.

  2. Conserva la invitación junto con el registro de consentimiento.

    Registra lo que la persona vio y cuándo aceptó, para que puedas demostrar qué cubre su permiso.

  3. La hora de consentimiento determina qué declaración se aplica.

    Una declaración de preferencia más antigua no puede reemplazar a una más reciente. Una marca de tiempo posterior por sí sola no puede anular la exclusión voluntaria de la propia persona.

  4. START finaliza una supresión.

    El manejo de palabras clave de Bird no reemplaza tu recopilación inicial de consentimiento ni tu controlador de confirmación de doble consentimiento.

Ponlo en práctica.

Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.

Obtener un resumen de implementación

Construye sobre la misma red.

Obtén una clave API de prueba de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

Empieza con un canal.
Añade los demás cuando estés listo.

Una clave API de prueba es tuya de inmediato. El acceso a producción se desbloquea cuando añades un método de pago y verificas un remitente.

¿Usas Claude Code, Cursor o Codex? Copia un prompt de configuración y tu agente instalará el Bird CLI y las habilidades por ti. Elige el tuyo:

Cursor