---
title: "Cómo funciona Raíz"
description: "Las partes de Raíz y cómo encajan, desde la organización y sus agentes hasta los canales, las conversaciones, los contactos y los datos que capturan los agentes."
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.getarbol.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Cómo funciona Raíz

Raíz es el producto de Arbol para el contacto con cada paciente. Sus agentes de IA hablan con los pacientes de una clínica o un hospital por teléfono, por WhatsApp y en un chat de su sitio web: responden cuando los pacientes se comunican y pueden llamarlos. Siguen las instrucciones que les das, consultan tus documentos, usan las herramientas de tus integraciones y le pasan una conversación a tu equipo cuando se necesita una persona. Todo lo que Raíz guarda pertenece a una organización, y llegas a ello a través de la [API de Raíz](/api/raiz/).

## El modelo

Raíz se compone de estas partes:

1. **La organización** es tu clínica u hospital. Cada solicitud a la API actúa en una organización: aquella a la que pertenece su credencial. Consulta [Organizaciones](/developers/concepts/organizations/).
2. **Los agentes** son la IA que habla por ti. Un agente es `voice`, para llamadas telefónicas, o `text`, para WhatsApp y el chat web.
3. **Los canales** son donde trabajan los agentes: un número de WhatsApp, un número de teléfono o un widget de chat en tu sitio. En cada uno asignas el agente que responde.
4. **Las conversaciones** ocurren en un canal, entre un agente, tu equipo y un **contacto**: el paciente, con sus números de teléfono, sus correos y sus documentos de identidad.
5. **Las definiciones y los hechos** son los datos que capturan los agentes. Una definición dice qué capturar; un hecho es su valor para un contacto o una conversación.
6. **Conocimiento** son los documentos que los agentes consultan antes de responder.
7. **Las campañas** hacen que un agente de voz llame a una lista de personas. **Las plantillas** abren conversaciones de WhatsApp. **Las novedades** les cuentan a los agentes lo que pasa durante un tiempo, como un día cerrado.
8. **Las evaluaciones** prueban un cambio en un agente con respuestas pasadas que tu equipo corrigió, antes de que llegue a los pacientes.
9. **Los reportes**, el **historial de cambios** y las **tareas** te dan las cifras, quién cambió qué y el trabajo que corre en segundo plano.

## Dónde se describe cada parte

| Parte | Se explica en | Referencia de la API |
| --- | --- | --- |
| Agentes | [Agentes](/developers/raiz/agents/) | [Agents](/api/raiz/tags/agents/), [Voices](/api/raiz/tags/voices/) |
| Canales | [Canales](/developers/raiz/channels/) | [Channels](/api/raiz/tags/channels/) |
| Conversaciones | [Conversaciones](/developers/raiz/conversations/) | [Conversations](/api/raiz/tags/conversations/) |
| Contactos, perfiles de contacto, reglas de no contactar | [Contactos](/developers/raiz/contacts/) | [Contacts](/api/raiz/tags/contacts/), [Profiles](/api/raiz/tags/profiles/), [Suppressions](/api/raiz/tags/suppressions/) |
| Conocimiento | [Conocimiento](/developers/raiz/knowledge/) | [Knowledge](/api/raiz/tags/knowledge/) |
| Campañas, plantillas, novedades | [Campañas, plantillas y novedades](/developers/raiz/campaigns/) | [Campaigns](/api/raiz/tags/campaigns/), [Templates](/api/raiz/tags/templates/), [Bulletins](/api/raiz/tags/bulletins/) |
| Evaluaciones | [Evaluaciones](/developers/raiz/evaluations/) | [Eval cases](/api/raiz/tags/eval-cases/), [Eval runs](/api/raiz/tags/eval-runs/) |
| Definiciones, hechos, reportes, cambios, tareas | [Datos, reportes y tareas](/developers/raiz/data/) | [Definitions](/api/raiz/tags/definitions/), [Facts](/api/raiz/tags/facts/), [Reports](/api/raiz/tags/reports/), [Changes](/api/raiz/tags/changes/), [Tasks](/api/raiz/tags/tasks/) |
| La organización y su equipo | [Más abajo](#la-organización) | [Organization](/api/raiz/tags/organization/), [Members](/api/account/tags/members/), [Roles](/api/account/tags/roles/) |

## Llamar a la API de Raíz

Todas las operaciones viven bajo `https://api.getarbol.com/v1/raiz/` y se llaman `raiz.<resource>.<verb>`, como [`raiz.agents.create`](/api/raiz/agents/create/). Todas aceptan por igual personas y máquinas, así que una [API key](/developers/authentication/) con los scopes adecuados puede llamar a cualquiera de ellas.

Los permisos (scopes) llevan el nombre del recurso, como `raiz:agents:read` y `raiz:agents:write`, y la mayoría de las lecturas también aceptan el scope de escritura. Algunos recursos toman prestados los scopes de otro: las novedades usan los scopes de agentes, y las evaluaciones necesitan un scope de agentes y uno de conversaciones. La página de referencia de cada operación lista exactamente qué scopes acepta.

Las listas se paginan con cursores ([Paginación](/developers/concepts/pagination/)), y las actualizaciones que reciben `expectedVersion` se aplican solo si nadie cambió el registro desde que lo leíste, y si no, responden `409 VERSION_CONFLICT` ([Reintentos](/developers/concepts/retries/)).

## La organización

[`raiz.organization.get`](/api/raiz/organization/get/) lee tu organización tal como la ve Raíz: su nombre, el `language` por defecto de sus agentes, su `timeZone`, en la que los reportes cuentan los días y las campañas corren por defecto, y sus `settings`:

| Ajuste | Qué hace |
| --- | --- |
| `channels.maxConcurrentOutboundCalls` | Cuántas llamadas de campaña corren a la vez (5 por defecto). |
| `notifications` | Si enviar un correo a hasta 10 `recipients` cuando la IA le pasa una conversación al equipo (`escalations`), cuando no pudo responder (`failures`) o cuando la solicitud de una conversación cerrada no se resolvió (`failedOutcomes`). Los `phones` también reciben por WhatsApp el aviso de traspaso. Todo desactivado por defecto. |
| `dailyReport` | Si enviar un reporte diario por correo, a la hora `sendAt`, a hasta 10 `recipients`: las llamadas y conversaciones de las últimas 24 horas, las que esperan a tu equipo y las que hay que revisar. Desactivado por defecto. |

[`raiz.organization.update`](/api/raiz/organization/update/) cambia el nombre, el idioma, la zona horaria y los ajustes: un ajuste omitido se queda como está, y `null` lo devuelve a su valor por defecto. [`raiz.organization.sendDailyReport`](/api/raiz/organization/send-daily-report/) envía el reporte diario ahora. Cuenta administra el equipo de la organización y sus roles mediante [`account.members.list`](/api/account/members/list/) y [`account.roles.list`](/api/account/roles/list/).

> **Los avisos nombran pacientes**
>
> Los correos de notificación llevan el título y el resumen de una conversación, y el reporte diario lista contactos por nombre y número. Envíalos solo a personas que puedan leer las conversaciones de tu organización.

## Empieza aquí

Para ver las partes funcionando juntas, [crea un agente](/developers/guides/create-an-agent/) y ponlo en un canal. Luego lee [Conversaciones](/developers/raiz/conversations/) para seguir lo que hace.

Source: https://docs.getarbol.com/developers/raiz/index.mdx