Crear un agente

Análisis de llamadas

Cuando termina una llamada, CallShift la analiza y extrae un resumen, un resultado y la información que pediste al agente que recopilara. Los encuentras en la llamada y en el webhook de fin de llamada.

Flags de resultado

Flag	Verdadero cuando
`isReached`	Contestó una persona
`isSignificant`	Hubo una conversación real
`isSuccessful`	La llamada cumplió su objetivo, tal como lo define el `evaluationPrompt` del agente
`isSilent`	Nadie habló

Los flags valen null hasta que se analiza la llamada. Juntos forman un embudo (marcadas, contactadas, significativas, logradas), y GET/v1/calls permite filtrar por cada uno.

Resumen y evaluación

Dos prompts del agente guían el análisis: summaryPrompt dice qué debe contener el resumen, y evaluationPrompt dice qué hace que una llamada se considere lograda.

JSON

{
  "summaryPrompt": "Summarise the call in two sentences: the caller's request and the outcome.",
  "evaluationPrompt": "The call is successful if the caller booked a visit."
}

Información que recopilar

informationToCollect enumera lo que el análisis extrae de cada llamada. Cada entrada tiene un name, un type (string, number, boolean o enum con sus enumValues) y una description.

JSON

{
  "informationToCollect": [
    { "id": "visit", "name": "Visit booked", "type": "boolean", "description": "Did the caller book a visit?" },
    { "id": "day", "name": "Preferred day", "type": "enum", "enumValues": ["Weekday", "Weekend"] },
    { "id": "goal", "name": "Fitness goal", "type": "string", "description": "In a few words" }
  ]
}

Los valores llegan en el qualificationCriteria de la llamada, con el nombre como clave:

JSON

{ "qualificationCriteria": { "Visit booked": "true", "Preferred day": "Weekend", "Fitness goal": "Run a half marathon" } }

Los nombres son claves

Cambiar el nombre de una entrada cambia su clave en todas las llamadas siguientes y rompe, sin avisar, los mapeos que la leen. Considera un nombre como fijo en cuanto lo consuma un CRM o un escenario. Los valores llegan como texto, también los boolean ("true" o "false"): compáralos como texto.

Totales de la campaña

GET/v1/campaigns/{campaignId} devuelve las metrics de una campaña: totalCalls, reached y callsCompleted.