Desarrollo
Manejar las notificaciones de tu empresa con Yo
Publicado el 17 de diciembre de 2015
Aprende a integrar la API de Yo en tus notificaciones diarias.
Introducción
Aquí en Connaxis recibimos notificaciones todos los días de diversas fuentes. Un cliente nuevo requiere un trabajo? Eso podría ser un correo electrónico a info@connaxis.com. Alguien pregunta sobre una oferta de trabajo? Prueba recruit@connaxis.com. Hay un nuevo concurso de diseño en Choosa (una de nuestras empresas), tal vez haya un pago de Stripe o Paypal.
Me gusta tener notificaciones rápidas sin tener que entrar en mi correo, o abrir un dashboard o panel. Con Yo, puedo recibir mensajes en mi smartphone que me dicen rápidamente qué está pasando. Además, Yo es divertido! Síganme mientras les muestro cómo integro las notificaciones de Yo en mi flujo diario.
Crear una cuenta en Yo
Ir a https://dev.justyo.co/ y crear una nueva cuenta o entrar con una cuenta existente. Hacer click en el boton de + Add Account. Ponganle un nombre descriptivo para la notificación que estan buscando (yo uso CONNAXIS_CLIENT, CONNAXIS_EMAIL, CHOOSA_STRIPE, CHOOSA_PAYPAL). Frases simples de una o dos palabras me dicen exactamente qué es lo que está pasando. Pueden subir una foto también si quieren. Pongan un correo electrónico donde puedan recuperar su cuenta en caso que pierdan la contraseña. Los otros campos no son mandatorios y los podemos dejar vacíos por ahora. Cuando crean una cuenta en Yo, tienen acceso a la llave del API. Necesitamos esa llave para poder enviar un Yo con esa cuenta.
Integrar la API de Yo en tus programas
En Connaxis usamos mucho PHP internamente, asi que cree un par de librerías open source que me ayudan a enviar Yos.
Yo-PHP es un script muy simple para enviar Yos con un par de lineas de código. Lo pueden bajar aqui: https://github.com/nanexcool/yo-php También usamos CakePHP para algunos proyectos, asi que cree un Plugin para CakePHP que envía Yos. Ese lo pueden descargar desde aqui https://github.com/nanexcool/yo-plugin-cakephp aunque no lo vamos a usar en este momento. Ahora, en el backend de nuestro sitio, cuando alguien (por ejemplo) aplica para una oferta de trabajo, en el código donde se envían correos, se actualiza la base de datos, se envía un post a Salesforce, etc., puedo hacer algo como esto:
<?php
// Agregar el archivo
require('yo.php');
// Consigue tu llave API en dev.justyo.co
$apiKey = 'YOUR_API_KEY';
$yo = new Yo($apiKey);
// Enviar un Yo a un usuario
$yo->user('MARIANO');
// Enviar un Yo con un link a un usuario
$link = 'http://www.connaxis.com/job_applications/12345';
$yo->user('MARIANO', $link);
?>
Muy simple! Si la llave del API es del usuario CONNAXIS_CV y mi usuario de Yo es MARIANO, el primer $yo->user(‘MARIANO’) me envia un simple Yo que yo veo que fue enviado por CONNAXIS_CV. Inmediatamente veo que alguien se postuló para una oferta laboral.
Si quiero enviar mas datos puedo agregar un link a mi Yo. En este caso, estoy adjuntando el URL para ver exactamente esa aplicación laboral. Si recibo este Yo y lo abro, se abre mi navegador con la página correcta.
Hacer más con Yo
Hay mucho más que se puede hacer con Yo. Se puede enviar datos de geolocalización en lugar de una URL. Combinando diferentes nombres de cuentas con localidad o links, un simple Yo puede contener mucha información.
Dejenme saber si encuentran un gran uso para Yo!