Delivyr SMS

Delivyr es un socio de SMS para mensajes a números de Estados Unidos y Canadá. Envía solo plantillas que Delivyr ha aprobado - no hay SMS de texto libre a través de Delivyr. Delivyr opera su servicio y guarda los datos de los mensajes en Estados Unidos.

Para quién es

Para empresas que envían SMS a destinatarios de Estados Unidos o Canadá y que ya tienen, o están abriendo, una cuenta en Delivyr. Tu espacio de trabajo de Joryio puede estar alojado en la UE o en Estados Unidos; lo que importa es que los destinatarios tengan números de Estados Unidos o Canadá (+1).

Conectar tu cuenta de Delivyr

Usas tu propia cuenta de Delivyr y la conectas tú mismo, desde la tarjeta de Delivyr en Integraciones. Necesitas dos datos de tu portal de Delivyr, ambos en Settings > General:

• tu Account ID de Delivyr
• una clave de API de Delivyr

1. Abre Integraciones y elige Delivyr (en Mensajería).
2. Introduce el Account ID y la clave de API. Si Delivyr le dio a tu cuenta un número de envío, también puedes introducirlo. Delivyr elige el número desde el que envía, así que Joryio solo lo muestra como remitente; sin él, el remitente aparece como "Delivyr".
3. Haz clic en Probar conexión para comprobar los datos con Delivyr y luego en Conectar Delivyr. Joryio los vuelve a comprobar, conecta la cuenta a este espacio de trabajo y lee tus plantillas por primera vez.

Una vez conectada, la tarjeta muestra el Account ID, el remitente, cuándo se sincronizaron las plantillas por última vez y cuántas hay, con Probar conexión, Actualizar plantillas, Reemplazar clave de API y Desconectar. Ese remitente es el que eliges en el paso de SMS de una campaña o un recorrido.

• Quién puede conectar. Solo los administradores del espacio de trabajo - el permiso Configuración: Escritura - pueden conectar, reemplazar la clave o desconectar. Los demás miembros ven la tarjeta pero no pueden cambiarla.
• La clave de API. Se guarda cifrada y no se vuelve a mostrar. Para cambiarla, usa Reemplazar clave de API; la nueva clave se prueba con Delivyr antes de guardarse.
• Varias cuentas por espacio de trabajo, un espacio de trabajo por cuenta. Un espacio de trabajo puede conectar varias cuentas de Delivyr - por ejemplo una por marca - y cada una aparece en la tarjeta con su propio nombre. Una cuenta de Delivyr solo puede conectarse a un espacio de trabajo de Joryio: Delivyr guarda las plantillas y la lista STOP por cuenta, así que una cuenta compartida por dos espacios de trabajo compartiría una lista STOP.
• Espacios de demostración. En una demo, la conexión solo funciona si Joryio ha abierto la demo a conexiones externas.
• Facturación. Como con cualquier cuenta de SMS que traigas, pagas a Delivyr por los mensajes según tu propio acuerdo con ellos, y Joryio añade su tarifa de plataforma por mensaje.

Si la prueba de conexión falla, la tarjeta dice por qué; por ejemplo, que Delivyr no aceptó el Account ID y la clave de API, o que no respondió. La conexión es nueva, así que si una comprobación falla de una forma que parece incorrecta, contáctanos y lo revisamos contigo. Contáctanos también si todavía no tienes una cuenta de Delivyr.

Varias cuentas de Delivyr

Un espacio de trabajo puede enviar a través de más de una cuenta de Delivyr, por ejemplo una por marca. Para añadir una, haz clic en Conectar otra cuenta de Delivyr debajo de las cuentas conectadas e introduce su Account ID y su clave API como arriba. Dale un Nombre - la marca, por ejemplo - para distinguir las cuentas: el nombre aparece en la tarjeta, al elegir el remitente de SMS y en la página Plantillas SMS. Sin nombre, la primera cuenta se llama "Delivyr" y las siguientes "Delivyr" más su Account ID. Puedes cambiar el nombre de una cuenta más tarde con el lápiz junto a su nombre.

Cada cuenta es independiente:

• Su propia tarjeta. Cada cuenta tiene su propio remitente, plantillas, Probar conexión, Actualizar plantillas, Reemplazar clave API y Desconectar. Desconectar una cuenta deja las demás conectadas.
• Sus propias plantillas. El editor de SMS muestra las plantillas de la cuenta a la que pertenece el número elegido, e indica esa cuenta. Una plantilla pertenece a una cuenta y solo se envía a través de ella: si cambias el número a otra cuenta, elige una de las plantillas de esa cuenta. La página Plantillas SMS muestra a qué cuenta pertenece cada plantilla y pregunta para qué cuenta es una plantilla nueva.
• Su propia URL de webhook y lista STOP. Cada cuenta tiene su propia URL de informes de entrega, y un STOP que informa una cuenta da de baja al contacto solo del número de esa cuenta.

Desconectar

Desconectar pide confirmación primero. Se rechaza mientras una campaña o un recorrido que está activo, programado, en pausa o esperando aprobación siga enviando a través de Delivyr; la tarjeta los muestra para que puedas detenerlos o pasarlos antes a otro número de SMS. Los borradores no lo impiden: la revisión de lanzamiento los señala cuando Delivyr ya no está. Desconectar elimina de este espacio de trabajo la clave guardada, el remitente de Delivyr y las plantillas sincronizadas. Nada cambia en tu cuenta de Delivyr.

Plantillas

Cada mensaje de Delivyr es una plantilla. Tus plantillas están en la página SMS Templates de Brand Studio, que aparece en cuanto Delivyr se conecta a tu espacio de trabajo.

• Creadas en el portal de Delivyr. Las plantillas que creas y se aprueban en el portal de Delivyr se sincronizan con Joryio cada 30 minutos, o al momento cuando haces clic en Actualizar desde Delivyr.
• Creadas en Joryio. Nueva plantilla envía la plantilla a revisión de Delivyr. Aparece En revisión hasta que Delivyr la aprueba o la rechaza.
• Plantillas de sistema de Delivyr. También aparecen las plantillas listas para usar de Delivyr, que se pueden enviar sin revisión.

El texto aprobado no se puede editar. Para cambiar la redacción, crea una plantilla nueva. Detalles, estados y consejos de redacción en Plantillas de SMS (Delivyr).

Enviar en campañas y recorridos

Cuando el número desde el que envías pertenece a una cuenta de Delivyr, el editor de SMS muestra un selector de plantillas en lugar del cuadro de mensaje - en las campañas y en el paso SMS de un recorrido.

1. Elige una plantilla aprobada. Las plantillas en revisión no aparecen.
2. Rellena cada {{variable}} de la plantilla. Escribe texto o usa personalización Liquid como {{ user.first_name }}; cada contacto recibe sus propios valores en el momento del envío.
3. Pon la URL de destino en {{link}}. Joryio la envía como su propio enlace corto con seguimiento, así que los clics se cuentan como en cualquier otro enlace de SMS.
4. Revisa la vista previa y usa Enviar SMS de prueba para enviar la plantilla a un número de prueba.

La revisión de lanzamiento señala un SMS en una cuenta de Delivyr que no tiene plantilla, usa una plantilla no aprobada o deja una variable vacía. Que esos avisos detengan el lanzamiento depende de la configuración de revisión de lanzamiento de tu espacio de trabajo, pero Delivyr nunca envía un mensaje así, de modo que corrígelos antes de lanzar. Más sobre el editor: Cuentas de Delivyr: plantillas aprobadas.

Consentimiento y bajas

• Delivyr gestiona STOP. Cuando un destinatario responde STOP, Delivyr deja de enviar a ese número desde tu cuenta. Las bajas y las reglas de consentimiento del propio Joryio se siguen aplicando antes de cada envío.
• Doble opt-in. Si el doble opt-in está activado en tu cuenta de Delivyr, Delivyr envía plantillas normales a un número solo después de que el destinatario confirme. Joryio tiene un estado de contacto equivalente, Pendiente de confirmación - consulta Gestión de suscripciones.

Cuando los informes de entrega están configurados, las bajas de Delivyr se copian al contacto en Joryio: un STOP lo da de baja de SMS, y una respuesta YES o UNSTOP lo vuelve a suscribir (y confirma a un contacto Pendiente de confirmación). Sin informes de entrega, las respuestas STOP y las confirmaciones se quedan solo en Delivyr. Cuando Delivyr mantiene la baja de SMS de un contacto, su página de contacto lo indica: puedes volver a suscribirlo en Joryio, pero Delivyr sigue bloqueando los SMS hasta que envíe START.

Doble opt-in por SMS. Delivyr tiene su propio doble opt-in, así que cuando el número de SMS de un espacio de trabajo está en una cuenta de Delivyr, el doble opt-in por SMS de Joryio no envía una segunda confirmación: los nuevos altas de SMS se registran como siempre y Delivyr retiene los mensajes a números sin confirmar ("Not confirmed yet") hasta que el contacto responde YES a Delivyr.

Informes de entrega, bajas y respuestas

Delivyr envía informes de entrega, bajas y respuestas solo a un webhook que añades en tu portal de Delivyr, y tú escribes el contenido que envía para cada evento. Joryio te da ambas cosas: una URL de webhook y un payload listo para cada evento. Hasta que los añadas, no vuelve nada - Joryio sabe que un mensaje se entregó a Delivyr, pero no si llegó, y las respuestas STOP no se copian al contacto en Joryio.

Configuración

1. Abre Integraciones > Delivyr y, en Informes de entrega, haz clic en Configurar informes de entrega. Solo los administradores del espacio de trabajo - Configuración: Escritura - ven la URL.
2. En tu portal de Delivyr, abre Settings > Webhooks y crea un webhook con la URL del webhook que muestra Joryio. La misma URL sirve para todos los eventos.
3. Suscribe el webhook a cada evento de la tabla de abajo. Para cada evento, pega el payload de Joryio (JSONata) - la tarjeta tiene un botón Copiar para cada uno, y también están más abajo.
4. Guarda. La tarjeta muestra cuándo llegó el último informe.

Evento de Delivyr	Qué hace Joryio con él
delivery_receipt	Marca el mensaje como Entregado, o Fallido con el motivo (no entregable, caducado, rechazado por el operador), en la analítica de campañas y recorridos.
rejected_message	Marca el mensaje como Fallido con el motivo de Delivyr. El código 1 (dado de baja) también da de baja al contacto de SMS.
opt_out	Un STOP da de baja al contacto de SMS para tu número de Delivyr. Un YES o UNSTOP lo vuelve a suscribir - solo cuando el propio Joryio recibió esa respuesta del contacto en tu número de Delivyr en las últimas 24 horas, y solo para tu número de Delivyr: una baja de SMS de tus otros números se mantiene.
incoming_messages	Guarda la respuesta en el contacto; puede iniciar o avanzar un recorrido, y {{ reply.text }} la lee. Una respuesta que es una palabra de baja (STOP, UNSUBSCRIBE, CANCEL, END, QUIT, REVOKE, OPT OUT y el resto de la lista de bajas de Joryio) también da de baja al contacto de SMS - una sola vez, aunque también llegue el informe opt_out de Delivyr por el mismo STOP. Una respuesta START o YES no lo vuelve a suscribir: solo el informe opt_out de Delivyr lo hace.
message_log	Confirma que Delivyr aceptó el mensaje.
event_log	Cuenta los clics en enlaces que Delivyr rastrea. Las vistas previas de enlaces hechas por robots no se cuentan.

Cada cuenta de Delivyr tiene su propia URL de webhook. Con varias cuentas de Delivyr, configura los informes de entrega en la tarjeta de cada cuenta y pega la URL de esa cuenta en el portal de Delivyr de esa misma cuenta. Los payloads son los mismos para todas las cuentas. Un informe que llega a la URL de una cuenta nunca se asocia a un mensaje enviado a través de otra cuenta.

Los payloads

Pega cada uno, sin cambios, como payload de su evento.

delivery_receipt

{ "version": 1, "type": "delivery_receipt", "id": id, "request_id": request_id, "message_log_id": message_log_id, "status": status, "status_mapped": status_mapped, "epoch": epoch }

rejected_message

{ "version": 1, "type": "rejected_message", "id": id, "request_id": request_id, "phone_number": phone_number, "rejection_code": rejection_code, "rejection_reason": rejection_reason }

opt_out

{ "version": 1, "type": "opt_out", "dml": dml, "phone_number": phone_number, "system_number": system_number, "incoming_log_id": incoming_log_id, "request_id": request_id }

incoming_messages

{ "version": 1, "type": "incoming_messages", "id": id, "from": from, "to": to, "body": body, "message_log_id": message_log_id, "request_id": request_id }

message_log

{ "version": 1, "type": "message_log", "id": id, "request_id": request_id, "sending_number": sending_number, "segments": segments, "testing": testing }

event_log

{ "delivyr_ignore": event != "click", "version": 1, "type": "event_log", "event": event, "message_log_id": message_log_id, "request_id": request_id }

• Versión. Cada payload lleva "version": 1. Si Joryio cambia el payload, la tarjeta lo indicará; pega entonces el nuevo. Un informe cuyo payload Joryio no reconoce se rechaza y se cuenta en la tarjeta.
• Mantén la URL en privado. Quien la tenga puede enviar informes y bajas para este espacio de trabajo. Si se filtra, haz clic en Crear una nueva URL en la tarjeta: la anterior deja de funcionar al instante, y los informes se detienen hasta que pegues la nueva URL en Delivyr.
• Solo cuentan tus mensajes. Joryio asocia cada informe con el mensaje que envió desde este espacio de trabajo. Un informe que no se puede asociar se cuenta en la tarjeta como no asociado y nunca se añade a un contacto ni a una campaña.

Límites actuales

• Sin SMS de texto libre. Cada mensaje debe ser una plantilla aprobada. Una campaña creada con la API con un mensaje de texto libre en una cuenta de Delivyr se rechaza.
• Solo Estados Unidos y Canadá. Un envío a un número fuera de +1 falla con "Delivyr sends to US and Canada (+1) numbers only" y no se reintenta.
• Los informes de entrega necesitan el webhook. Los mensajes entregados y fallidos, las bajas y las respuestas llegan a Joryio solo después de añadir el webhook de Joryio en tu portal de Delivyr - consulta Informes de entrega, bajas y respuestas. Los informes de entrega son nuevos: si la tarjeta muestra informes que no se pudieron asociar a un mensaje mientras Entregados se queda en cero, contáctanos.

API pública

Las mismas plantillas están disponibles en la API REST pública, solo para espacios de trabajo con Delivyr. Consulta Plantillas de SMS en la Messaging API.