Calendly
Conecte Calendly con un token de acceso personal para que un agente pueda buscar horarios libres, reservar reuniones y cancelarlas durante una llamada.
Qué conseguirá
Un agente podrá ofrecer horarios libres reales de Calendly, reservar uno para quien llama y cancelar una reserva, todo durante la llamada.
Descripción general y casos de uso
- Reservar citas o demostraciones sin que quien llama abra un enlace.
- Ofrecer un enlace de agenda de un solo uso cuando quien llama prefiere elegir más tarde.
- Comprobar o cancelar una reunión próxima.
Requisitos previos
- Una cuenta de Calendly con un plan de pago. Reservar a través de la API no está disponible en los planes gratuitos (Calendly responde 403).
- Permiso para crear un token de acceso personal.
Configuración de la cuenta externa (en Calendly)
Calendly controla estas pantallas. La guía de Calendly: Personal access tokens.
- En Calendly, abra Integrations & apps y después API and webhooks (enlace directo).
- Cree un personal access token.
- Marque los ámbitos (scopes) de abajo al crearlo. Los tokens creados desde que se introdujeron los ámbitos no tienen acceso hasta que se eligen.
- Copie el token; Calendly lo muestra una sola vez.
Conéctelo en Phynxa
- Integrations, Connect en Calendly.
- Pegue el Personal access token. Opcionalmente escriba un Default event type (el URI o el id de un tipo de evento) para reservar cuando el agente no nombre ninguno.
- Elija Check and connect. La tarjeta muestra Connected.
Permisos y ajustes
Ámbitos que debe marcar: users:read, event_types:read, availability:read, scheduled_events:write, scheduling_links:write.
Úselo en una llamada
| Acción | Qué hace | Se ejecuta |
|---|---|---|
| Find available times | Enumera los huecos libres de un tipo de evento, hasta 31 días por delante, a partir de ahora. | Espera |
| Book meeting | Reserva un hueco para quien llama. Necesita una hora de inicio de la lista y el correo de quien llama; la zona horaria es UTC si no se indica. | En segundo plano |
| Create scheduling link | Crea un enlace de un solo uso que puede usar quien llama. | Espera |
| List scheduled events | Reuniones próximas, opcionalmente de un solo correo. | Espera |
| Cancel event | Cancela una reunión reservada por su id, con un motivo opcional. | En segundo plano |
| List event types | Lista los tipos de reunión que se pueden reservar. | Espera |
Pruébelo
- Test connection debe responder «Calendly is responding.»
- En el Chat de un agente, pregunte «What times do you have next week?», elija uno y dé un correo. Compruebe la reserva en Calendly.
Resultado esperado
Los huecos mostrados coinciden con su disponibilidad de Calendly, y un hueco reservado aparece en Calendly y envía el correo de confirmación habitual.
Solución de problemas
- 403 en todas las acciones. El token se creó sin ámbitos, o su plan es gratuito. Cree un token nuevo con los ámbitos marcados.
- «No event type.» Fije un Default event type, o pida al agente que nombre uno.
- Se rechaza el hueco. La hora debe seguir libre, estar en el futuro y dentro de los 31 días.
Seguridad y credenciales
El token se almacena cifrado y no se vuelve a mostrar. Elimine el token en Calendly para revocarlo. Remove en Phynxa lo elimina aquí.
Guías relacionadas
¿Algo de esto no coincide con lo que ve en el panel? Avísenos.