# Webhook y API

### 1. Webhooks <a href="#id-1-webhooks" id="id-1-webhooks"></a>

* **¿Cuándo Usarlos?**
  * Los webhooks activan eventos en sistemas externos en tiempo real cuando algo sucede en [**BeepCall.ai**](http://beepcall.ai/).
  * Ejemplo:

    > "Llamada finalizada" → Enviar datos al CRM.
* **Configuración:**
  1. Configura una URL de webhook en:
     * La **configuración de tu asistente** o campaña.
     * La **plataforma de automatización** de [**BeepCall.ai**](http://beepcall.ai/).
  2. Define las acciones deseadas al recibir la notificación.
* **Carga Útil (Payload):**
  * Incluye datos clave como:
    * **Identificación de la llamada.**
    * **Transcripción.**
    * **Resultado de la llamada.**
    * Datos del usuario recopilados durante la conversación.

***

### 2. API REST <a href="#id-2-api-rest" id="id-2-api-rest"></a>

* **Funciones Clave:**
  * **Gestión de Clientes Potenciales:**
    * Crear, actualizar o eliminar datos de clientes potenciales.
  * **Administración de Campañas:**
    * Crear, modificar o monitorear campañas salientes.
* **Límites y Autenticación:**
  * Utiliza **tokens de API** para autenticar solicitudes.
  * Respeta las cuotas de uso (detalladas en la **documentación de API oficial**).
* **Referencia de Puntos Finales:**
  * Consulta la **documentación de API** para obtener información completa sobre:
    * Puntos finales disponibles.
    * Parámetros requeridos.
    * Respuestas de las solicitudes.

***

### 3. Ejemplos de Casos de Uso <a href="#id-3-ejemplos-de-casos-de-uso" id="id-3-ejemplos-de-casos-de-uso"></a>

* **Sincronización en Tiempo Real con CRM:**
  * Para cada nueva llamada, publica datos en el punto final de tu sistema CRM (por ejemplo, Salesforce o HubSpot).
* **Paneles Personalizados:**
  * Extrae datos de llamadas (transcripciones, duración, resultados) para visualizarlos en tu propio panel de análisis.

***

### Nota Importante <a href="#nota-importante" id="nota-importante"></a>

* **Referencia Oficial de la API:**
  * Disponible en la **documentación dedicada** o en el panel de control de [**BeepCall.ai**](http://beepcall.ai/).
* **Seguridad:**
  * Protege siempre tus **tokens** y puntos finales.
  * Realiza pruebas en un entorno de desarrollo antes de implementar en producción.
