Saltar al contenido principal

Comunicación: llamadas

Conectar tu centralita

Actualizado el 10 de noviembre de 2026

La idea es que GuauKit no tenga que hablar el idioma de cada fabricante: tu centralita —o un flujo de n8n o Zapier delante de ella— manda un aviso pequeño y firmado cuando una llamada empieza y cuando termina. Eso lo puede hacer cualquiera: 3CX, Ringover, VoIPstudio, Asterisk, Zadarma…

Los dos datos que necesitas

  1. Elige Mi centralita y pulsa Generar el secreto. Cópialo en ese momento: se enseña una sola vez. Si lo regeneras, hay que actualizarlo en la centralita.
  2. Copia la dirección que aparece justo debajo, del tipo …/api/voice/generic/<id de tu entidad>.

Lo que tiene que mandar la centralita

Un POST con este JSON, al empezar y al terminar cada llamada:

{
  "callId": "id-en-tu-centralita",
  "direction": "inbound",
  "from": "+34600112233",
  "to": "+34910000000",
  "status": "completed",
  "startedAt": "2026-07-25T10:15:00Z",
  "durationSec": 184,
  "recordingUrl": "https://…/grabacion.mp3"
}
  • callId y direction son obligatorios. El callId es lo que evita que la misma llamada se registre dos veces: manda el mismo al empezar y al terminar.
  • status admite: ringing, in_progress, completed, missed, voicemail, busy, failed, cancelled.
  • startedAt en formato ISO; si falta, se usa la hora de llegada del aviso.
  • recordingUrl es opcional: si la mandas, GuauKit descarga el audio y lo guarda con la llamada. Si esa URL pide usuario y contraseña, se pueden enviar en recordingAuth.

Cómo se autentica

Dos formas, y la primera es la buena:

  • Firma — cabecera X-GuauKit-Signature con el HMAC-SHA256 del cuerpo usando tu secreto.
  • Bearer — cabecera Authorization: Bearer <tu secreto>, para centralitas que no saben firmar. Funciona, pero el secreto viaja entero en cada petición.

Las extensiones

Los avisos de una centralita no hablan de personas, hablan de extensiones: «la 101 ha cogido la llamada». En la misma pantalla se asigna qué extensión tiene cada miembro del equipo. Sin esa correspondencia, las llamadas quedan registradas pero sin saber quién las atendió, que es la mitad del valor del registro.


¿Esto no te resuelve la duda?

Si ya usas GuauKit, abre un aviso desde Soporte, en la propia aplicación: nos llega con tu centro y tu plan, y te contestamos allí mismo. Si todavía no tienes cuenta, escríbenos.