Mail API
La API de correo le permite enviar SMS, RCS y pronto también mensajes de voz a través de seven por correo. Envíe un correo al gateway, que luego será automáticamente convertido en un mensaje por nosotros. A través de numerosos parámetros, puede controlar el envío de manera específica y también enviar mensajes a contactos o grupos.
Configuración
En su inicio de sesión en la sección Desarrollador bajo Mail API puede configurar la API para su cuenta. Puede especificar tantas direcciones de remitente como desee, cada una con una clave diferente.
- 1
Configurar dirección del remitente
A través del ícono verde + en la parte inferior derecha de la sección Mail API, accederá a la ventana donde puede crear una nueva dirección de remitente.
- 2
Establecer clave
Debe elegir una clave para cada dirección de correo que haga el envío más seguro. Puede elegir la clave libremente, sin embargo, solo se permiten letras minúsculas y mayúsculas, números y los caracteres especiales guion, guion bajo y signo de dólar.
- 3
Manejo de errores
Aquí también puede especificar una dirección de correo opcional para recibir mensajes de error. Si no la especifica, recibirá los mensajes de error en la dirección del remitente si activa la función "Notificar en caso de errores" en la configuración (ver abajo). Los remitentes recién configurados están disponibles inmediatamente después de guardar.
- 4
Configuración
Al hacer clic en los engranajes azules, accederá a las opciones de configuración para la API de correo.
Configuración de la API de correo
- Longitud máxima: Establezca un número máximo de caracteres para evitar mensajes demasiado largos al incluir firmas. Ingrese 0 para desactivar esta función.
- Eliminar citas: Si está activado, la API intentará eliminar automáticamente el texto citado en el correo.
- Notificar en caso de error: Esta opción determina si desea recibir una notificación por correo en caso de errores. Por ejemplo, si el envío del mensaje falla o si los datos como el número, la clave, etc., están mal especificados o faltan en su correo electrónico, le enviaremos directamente un correo con información sobre el error. Al crear una nueva dirección de remitente, puede especificar opcionalmente una dirección de correo alternativa para recibir los mensajes de error.
- Incluir remitente del correo en el texto: Aquí puede configurar si desea enviar una parte de la dirección de correo al inicio de su mensaje. Puede elegir entre tres opciones:
| Configuraciones | Explicación |
|---|---|
| Dirección completa | Inserta la dirección completa, por ejemplo, "unusuario@dominio.de" |
| Parte local de la dirección | Por ejemplo, en unusuario@dominio.de se inserta "unusuario" |
| No | No envía la dirección del remitente |
Enviar mensaje
Estructura del correo
Por favor, utilice el formato descrito a continuación para sus correos al enviar a nuestro Gateway. Si su aplicación no puede ser adaptada para enviar correos en este formato, contáctenos – ¡la API de correo es flexible y adaptable!
Destinatario
Para enviar un mensaje a través de la API de correo, envíe un correo a destinatario@gateway.seven.io y reemplace destinatario con el número del destinatario o con el nombre de contacto de su libreta de direcciones.
Por ejemplo, si desea enviar un mensaje al número 01761234567890, el destinatario debe ser 01761234567890@gateway.seven.io.
Asunto
En el asunto, ingrese los parámetros necesarios para controlar el envío del mensaje. Estos deben estar separados por un espacio. Para establecer un parámetro, escriba el nombre del parámetro, seguido de un signo igual y el valor del parámetro.
Por ejemplo, con unParametro=unValor se establece el parámetro unParametro en unValor. Si el parámetro contiene espacios, debe encerrarlo entre comillas dobles " – por ejemplo, unParametro="Un valor con espacios".
Contenido
El texto del mensaje debe enviarse en el cuerpo del correo electrónico. El Gateway utiliza primero la parte text/plain del correo. Si el correo solo contiene una parte text/html sin alternativa de texto, se intentará analizarlo y extraer el texto del contenido HTML. Naturalmente, este método no siempre funciona como se desea.
Puede encerrar opcionalmente el texto del mensaje con ## para evitar que las líneas vacías o la firma del correo se incluyan en el mensaje. El texto se vería así: ##Este es el texto## - solo la parte entre ##...## se enviará en el mensaje.
Parámetros
Todos los parámetros se especifican en el asunto del correo como se mencionó anteriormente. Si no le es posible cambiar el asunto del correo, también puede especificar los parámetros en la dirección del destinatario de la siguiente manera:
01761234567890.from=ZahnPraxis@gateway.seven.io01761234567890.from=ZahnPraxis.type=rcs@gateway.seven.iokey=MAIL_API_KEY.from=ZahnPraxis.to=01761234567890@gateway.seven.io
Aquí hay un resumen de los posibles parámetros:
- Name
key- Type
- string
- Optional
- Optional
- Description
- La clave de acceso que ha especificado en sus configuraciones de Mail-API para el correo electrónico del remitente correspondiente.
- Name
from- Type
- string
- Optional
- Optional
- Description
- El remitente del mensaje. Si no se especifica nada aquí, se utilizará el remitente predeterminado de sus configuraciones de SMS. Se permiten hasta 11 caracteres alfanuméricos o hasta 16 caracteres numéricos.
- Name
to- Type
- string
- Optional
- Optional
- Description
- El destinatario del mensaje. Este parámetro sobrescribe,
si se especifica, al destinatario que se indicó en la dirección del destinatario del correo. Por ejemplo,
podría enviar un correo a acme-inc@gateway.seven.io con el parámetro
to=0176123456789. El mensaje se enviará a 0176123456789.
- Name
label- Type
- string
- Optional
- Optional
- Description
- Opcionalmente, establezca una etiqueta propia para cada
mensaje para poder asignarlos en sus estadísticas. Si no se especifica, se utilizará automáticamente el
remitente del correo como etiqueta. Caracteres permitidos:
a-z, A-Z, 0-9, .-_@
- Name
text- Type
- string
- Optional
- Optional
- Description
- Si no le es posible colocar el texto del mensaje en el
contenido del correo, puede ingresarlo a través del parámetro
texten el asunto.
- Name
flash- Type
- boolean
- Optional
- Optional
- Description
- Envíe un SMS Flash, que se muestra directamente en la pantalla del destinatario y no se guarda. Solo para el tipo de mensaje SMS.
- Name
unicode- Type
- boolean
- Deprecated
- Deprecated
- Optional
- Optional
- Description
- Permite la codificación del mensaje como Unicode o fuerza GSM 03.38.
- Name
performance_tracking- Type
- boolean
- Optional
- Optional
- Description
- Activa nuestro acortador de URL y el seguimiento de rendimiento para los enlaces encontrados en el texto.
- Name
foreign_id- Type
- string
- Optional
- Optional
- Description
- Proporcione su propia ID para este mensaje. Recibirá
el foreign_id de nuevo en las devoluciones de llamada para informes de estado, etc. Máx. 64 caracteres,
caracteres permitidos:
a-z, A-Z, 0-9, .-_@.
- Name
delay- Type
- string
- Optional
- Optional
- Description
- Programa el envío diferido del mensaje en el futuro. Proporcione aquí un Unix Timestamp o el momento en el formato AAAA-MM-DD hh:mm:ss.
- Name
type- Type
- enum
- Optional
- Optional
- Description
- Establezca el tipo de mensaje que desea enviar. Las
opciones posibles son
sms(estándar),rcsy próximamente tambiénvoice.
Seguridad
El camino de transporte entre los distintos servidores SMTP o el cliente SMTP suele estar cifrado mediante TLS. Sin embargo, por varias razones, es recomendable cifrar el correo, por lo que la API de correo admite cifrado mediante PGP y S/MIME:
-
Confidencialidad: PGP y S/MIME cifran el contenido de los correos electrónicos, de modo que solo el destinatario previsto puede descifrarlos y leerlos. Esto garantiza la confidencialidad de la comunicación.
-
Autenticación: Ambos estándares permiten verificar la identidad del remitente. Las firmas digitales, creadas con la clave privada del remitente, permiten al destinatario asegurarse de que el correo electrónico realmente proviene de la fuente indicada y no ha sido manipulado.
-
Integridad: PGP y S/MIME ofrecen mecanismos para verificar la integridad de los correos electrónicos. Mediante firmas digitales, el destinatario puede asegurarse de que el contenido del correo no ha sido alterado desde su envío.
-
Defensa contra ataques Man-in-the-Middle: Mediante el cifrado y la autenticación, PGP y S/MIME ayudan a prevenir ataques Man-in-the-Middle, en los que un atacante intercepta, manipula y luego reenvía el tráfico de datos sin que las partes involucradas lo noten.
En general, PGP y S/MIME son útiles para garantizar la seguridad, confidencialidad e integridad de la comunicación por correo electrónico, especialmente en entornos donde se intercambian información sensible o confidencial.
Para un envío cifrado de los correos, descargue el certificado correspondiente e instálelo en su sistema. Dado que los certificados PGP y S/MIME solo pueden estar vinculados a una única dirección de correo electrónico, envíe sus correos a la dirección de correo electrónico indicada a continuación para el certificado.
Datos como el destinatario del mensaje deben especificarse en el asunto mediante los parámetros correspondientes, como por ejemplo to=017612345678.
Aquí puede descargar el certificado correspondiente:
DMARC, DKIM, SPF
DKIM, SPF y DMARC son mecanismos para mejorar la seguridad del correo electrónico. Ayudan a verificar la autenticidad de los correos electrónicos, combatir el spam y el phishing, así como mejorar la entregabilidad de los correos electrónicos.
La API de correo rechaza correos si no cumplen con los estándares de autenticación establecidos por su configuración de DKIM, SPF y DMARC. Esto puede ocurrir, por ejemplo, si un correo electrónico no tiene una firma DKIM válida, la dirección IP del remitente no está autorizada en los registros SPF o las políticas DMARC del propietario del dominio prevén el rechazo de correos electrónicos no autenticados.
Por favor, tenga esto en cuenta al implementar la API de correo. Puede ver los correos rechazados en su Depurador.
Ejemplos
Primer ejemplo
En el primer ejemplo, se envía un SMS al número 0163123456789 del remitente ZahnPraxis. La clave en este caso es email2sms_key.
El texto que se debe transmitir en el SMS es:
Hola Sr. Schubert, por la presente queremos recordarle su cita el 20 de enero en nuestra clínica. ¡Esperamos verle! Hasta entonces, su clínica dental
Segundo ejemplo
En este segundo ejemplo, se envía un SMS al contacto Bartscher del remitente Optiker. El número predeterminado 0163123456789, que está en el destinatario del correo, se sobrescribe mediante el parámetro to. La clave aquí es 123456789.
El texto que se debe transmitir en el SMS es:
Hola Sra. Bartscher, ¡sus gafas están listas! Por favor, recójalas pronto en nuestra tienda. ¡Esperamos verle! Hasta entonces, su óptica – la firma del correo al final no se enviará en el SMS, ya que el texto está delimitado por ##.
Tercer ejemplo
En este ejemplo, se envía un SMS al número 0163123456789. La configuración para el remitente se toma de las configuraciones predeterminadas de su cuenta en Configuración > SMS. La clave está integrada directamente en el destinatario del correo y se establece en abcd123456.
El texto que se debe transmitir en el SMS es:
Hola Sra. Bartscher, ¡sus gafas están listas! Por favor, recójalas pronto en nuestra tienda. ¡Esperamos verle! Hasta entonces, su óptica
La firma del correo al final no se enviará en el SMS, ya que el texto está delimitado por ##.
Legacy
Por razones de compatibilidad con versiones anteriores, la API de correo se mantiene en la antigua dirección de destinatario email2sms@sms77.de para correos en el formato de entonces. Los correos seguirán siendo procesados como de costumbre. Sin embargo, recomendamos cambiar a esta nueva API para poder aprovechar todas las funcionalidades.
Parece que no has pegado ningún contenido. Por favor, proporciona el contenido en Markdown que necesitas traducir, y estaré encantado de ayudarte.