Conecte otros programas: API, webhooks y avisos en Slack o Teams

En Integraciones (dentro de Ajustes) puede conectar Kaam360 con otros programas. Forma parte del paquete Business. Solo los administradores pueden abrirlo.

Lea sus datos con una clave de API

1. Abra Ajustes y elija Integraciones.
2. En Claves de API, escriba un Nombre (por ejemplo Zapier u Hoja de contabilidad) y pulse Crear clave de API.
3. Copie la clave que aparece. Solo se muestra una vez. Cualquiera que tenga la clave puede leer todos los datos de su organización, así que manténgala en privado.
4. Entregue la clave al programa. La envía en la cabecera Authorization: Bearer .... La sección Usar la API muestra las direcciones y un ejemplo.
5. Una clave solo puede leer, salvo que marque Permitir que esta clave añada leads al crearla. Entonces también puede añadir leads. Nunca puede cambiar ni borrar nada más. Pulse Revocar para detener una clave al instante. Una clave también deja de funcionar cuando se desactiva en Usuarios a la persona que la creó; cree una nueva desde la cuenta de otro administrador.

Use Zapier o Make

Zapier y Make enlazan programas sin programar. No necesita una aplicación especial de Kaam360.

1. Cree una clave de API como arriba. Marque Permitir que esta clave añada leads si quiere que formularios, anuncios u hojas envíen leads a Kaam360.
2. En Zapier o Make, elija un paso que llame a una dirección web (en Zapier: Webhooks by Zapier; en Make: HTTP). Use la cabecera Authorization: Bearer ... con su clave.
3. Para leer datos, llame a las direcciones de Usar la API (por ejemplo /api/v1/leads o /api/v1/deals). Para añadir un lead, envíe un POST a /api/v1/leads con el apellido o el correo del lead.
4. Usar la API también enlaza a /api/v1/openapi.json, la descripción completa de la API. La guía completa para desarrolladores, con la API más nueva (versión 2), está en /developers.
5. Para enterarse cuando ocurra algo, use Otro programa (JSON firmado) en los webhooks.

Reciba avisos en Slack o Microsoft Teams

1. En Slack o Teams, cree un webhook entrante para el canal que quiera y copie su dirección web.
2. En Integraciones, en Webhooks y alertas de chat, escriba un Nombre, elija Un canal de Slack o Un canal de Microsoft Teams y pegue la Dirección web.
3. En Avisar cuando, marque lo que quiere saber. No marque nada para saberlo todo.
4. Pulse Añadir dirección y luego Enviar prueba. Debería aparecer un mensaje corto de prueba en el canal.

Avise a otro programa

1. Elija Otro programa (JSON firmado) y escriba su dirección web. Debe empezar por https:// y estar en internet pública.
2. Copie el secreto de firma que aparece. Solo se muestra una vez. El otro programa lo usa para comprobar que un mensaje viene de verdad de Kaam360.
3. Cada mensaje es JSON con un id, el nombre del evento, un resumen corto y los datos principales. Use la API para obtener el registro completo.
4. Cada mensaje va firmado: la cabecera X-Kaam360-Signature contiene un HMAC-SHA256 de la hora de envío (X-Kaam360-Timestamp) y del mensaje. El receptor debe rechazar un mensaje con más de cinco minutos, para que un mensaje copiado no pueda reenviarse más tarde. La guía para desarrolladores tiene código listo para esta comprobación.
5. Para cambiar una dirección, sus eventos o su nota, pulse Editar. Si el secreto pudo filtrarse, pulse Nuevo secreto de firma: el anterior deja de funcionar al instante, así que entregue el nuevo al otro programa enseguida.

De qué puede enterarse

Se añadió un cliente o un lead, se ganó o perdió un trato, se creó o cambió un proyecto, se añadió, cambió o completó una tarea, se escribió, emitió (envió), pagó o anuló una factura, un pago de proyecto cambió de etapa, se firmó un contrato y se abrió un ticket de soporte.

El registro de entregas

El Registro de entregas lista cada mensaje de las últimas dos semanas: cuándo se envió, a qué dirección, la respuesta del receptor (código de estado y duración) y el resultado.

1. Elija una dirección, un resultado (Entregados, Esperando reintento, Abandonado) o un evento para ver solo esos.
2. Pulse Mostrar lo que se envió para ver el mensaje y el inicio de la respuesta del receptor.
3. Pulse Enviar de nuevo para reenviar un mensaje entregado o abandonado. Conserva el mismo id, así el receptor sabe que es una repetición.

Si algo sale mal

• Si el receptor no responde, Kaam360 lo reintenta tras 1 minuto, 5 minutos, 30 minutos, 2 horas y 12 horas, y después lo abandona.
• Una dirección que falla 15 veces seguidas se desactiva, y todos los que pueden gestionar integraciones reciben un correo. Una nota roja en la página indica cuándo ocurrió. Corrija el problema, pulse Reanudar y reenvíe los mensajes perdidos desde el Registro de entregas.
• No se permiten direcciones dentro de una red privada (como localhost, 10.0.0.1 o 192.168.1.5), y se vuelven a comprobar en cada envío.
• Si no ve Integraciones, puede que su paquete no lo incluya o que su rol no tenga el derecho Gestionar integraciones.