Eventos de plataforma

Los eventos de plataforma son eventos activados por acciones que realizan los usuarios en las plataformas con las que interactúa Dialogflow, como el Asistente de Google, Slack y Facebook Messenger. Estos eventos te ofrecen una manera de responder a la acción del usuario en tu agente de Dialogflow y en la entrega.

Eventos de bienvenida

Los eventos de bienvenida se activan cuando un usuario inicia una conversación con tu acción, bot, habilidad o interfaz. Cuando creas un agente nuevo, se agrega automáticamente un intent de bienvenida predeterminado. Tales intents tienen respuestas de texto y un evento de WELCOME predefinido. El evento de WELCOME es un evento genérico para integraciones de un clic compatibles. Es una manera corta de configurar todos los eventos de bienvenida.

Cuando el usuario final activa un intent de bienvenida desde una plataforma de mensajería compatible, el evento correspondiente se envía a Dialogflow. Si no existe otro intent con un evento definido específico de una plataforma de mensajería determinada, se activa el intent de bienvenida predeterminado.

Por ejemplo, si un usuario hace clic en el botón "Comenzar" para indicar que le gustaría chatear con tu bot de Facebook Messenger, se activa el evento de bienvenida de Facebook. Primero, Dialogflow busca los intents que contengan el evento FACEBOOK_WELCOME. Si no se encuentra ese intent, se activa el intent de bienvenida predeterminado.

Plataforma Evento Descripción
Varias WELCOME Evento de bienvenida genérico para cualquier plataforma. Se activa cuando se activa cualquier evento de bienvenida.
Telefonía TELEPHONY_WELCOME Se activa cuando alguien llama al número de teléfono asociado a tu agente de Dialogflow.
Actions on Google GOOGLE_ASSISTANT_WELCOME Se activa cuando un usuario inicia una conversación con tu acción.
Alexa ALEXA_WELCOME Se activa cuando un usuario inicia una conversación con tu habilidad.
Facebook FACEBOOK_WELCOME Se activa cuando un usuario inicia una conversación con tu bot de Facebook Messenger.
Kik KIK_WELCOME Se activa cuando un usuario inicia una conversación con tu bot de Kik.
Skype SKYPE_WELCOME Se activa cuando un usuario inicia una conversación con tu bot de Skype.
Slack SLACK_WELCOME Se activa cuando un usuario inicia una conversación con tu bot de Slack.
Telegram TELEGRAM_WELCOME Se activa cuando un usuario inicia una conversación con tu bot de Telegram o escribe /start.
Viber VIBER_WELCOME Se activa cuando un usuario inicia una conversación con tu bot de Viber.

Eventos de Actions on Google

Si un usuario está en comunicación con tu Acción de otra manera que no sea mediante voz o texto, estas interacciones se envían a Dialogflow a través de eventos. Estos eventos pueden indicar algo como la entrada del usuario (por ejemplo, qué elemento de lista seleccionó el usuario, confirmaciones y direcciones de entrega), obtener permiso para la información del usuario (como el nombre de la ubicación del usuario) o realizar una transacción (como programar citas o comprar productos).

Actions on Google llama a estos eventos "intents de Actions on Google". Puedes encontrar la documentación sobre los intents de Action on Google aquí.

Entrada del usuario

Dialogflow usa eventos para comunicar las entradas del usuario que no sean de voz o de texto desde Actions on Google:

Nombre del evento Descripción
actions_intent_CANCEL Se activa cuando el usuario indica que desea dejar de conversar con tu Acción para que puedas enviar una respuesta final.
actions_intent_NO_INPUT Se activa cuando el usuario no proporciona ninguna entrada (se agotó el tiempo de espera mientras se esperaba que el usuario respondiera).
actions_intent_MEDIA_STATUS Se activa cuando el contenido que está reproduciendo tu Acción ha terminado.
actions_intent_CONFIRMATION Se activa cuando el usuario confirma una solicitud (por ejemplo, una respuesta a una pregunta de sí o no).
actions_intent_DATETIME Se activa cuando un usuario responde a tu solicitud de una hora o fecha.
actions_intent_DELIVERY_ADDRESS Se activa cuando un usuario responde a tu solicitud de una dirección de entrega.
actions_intent_PLACE Se activa cuando un usuario responde a tu solicitud para obtener una dirección o una ubicación guardada.
actions_intent_OPTION Se activa cuando un usuario selecciona un elemento de una lista o carrusel (Nota: Esto solo ocurre inmediatamente después de que se envía al usuario la lista o carrusel. Si se selecciona un elemento después de que la conversación haya continuado, la entrada se interpretará como un diálogo basado en el título del elemento).

Intents integrados

Dialogflow es compatible con los intents integrados de Actions on Google a través de eventos. Consulta la página de los intents integrados de Actions on Google para obtener más información.

Evento de Dialogflow para intent integrado de Actions on Google
actions_intent_PLAY_GAME
actions_intent_RESERVE_TAXI
actions_intent_HEAR_JOKE
actions_intent_HEAR_QUOTE
actions_intent_HEAR_FACT
actions_intent_TAKE_QUIZ
actions_intent_GET_FORTUNE
actions_intent_GET_HOROSCOPE
actions_intent_GET_JOKE
actions_intent_GET_QUOTATION
actions_intent_GET_CREDIT_SCORE
actions_intent_GET_CRYPTOCURRENCY_PRICE
actions_intent_CHECK_WATERSPORTS_CONDITIONS
actions_intent_CHECK_AIR_QUALITY
actions_intent_CHECK_WATER_CONDITIONS
actions_intent_START_CALMING_ACTIVITY

Solicitud de permiso

Dialogflow usa eventos para comunicar eventos de permiso de Action on Google, como solicitud de la ubicación de un usuario, vínculo directo, vinculación de cuenta y configuración de actualizaciones para notificar de manera proactiva a un usuario.

Evento Descripción
actions_intent_PERMISSION Se activa cuando el usuario responde a una solicitud de tu Acción para acceder al nombre completo del usuario, la ubicación aproximada o precisa, o a los tres datos.
actions_intent_LINK Se activa si un usuario rechaza tu solicitud de vínculo directo con tu aplicación para Android.
actions_intent_SIGN_IN Se activa durante el flujo de la vinculación de cuenta para vincular una cuenta de usuario a tu servicio.
actions_intent_REGISTER_UPDATE Se activa después de que un usuario confirme o rechace una solicitud de notificaciones.
actions_intent_CONFIGURE_UPDATES Se activa cuando el usuario indica que quiere configurar las notificaciones.
actions_intent_NEW_SURFACE Se activa cuando el usuario responde a una solicitud de transferencia a otra superficie/dispositivo del Asistente en la misma cuenta del usuario.

Transacción

Dialogflow usa los eventos para comunicar los pasos de transacción de Actions on Google, como verificar que se cumplan los requisitos de la transacción y comunicar la decisión de un usuario de confirmar o rechazar una transacción específica. Si deseas obtener más información, consulta la documentación de transacción de Actions on Google.

Evento Descripción
actions_intent_TRANSACTION_REQUIREMENTS_CHECK Se activa después de una solicitud para obtener información sobre si el usuario cumple con los requisitos para realizar una transacción.
actions_intent_TRANSACTION_DECISION Se activa cuando un usuario confirma o rechaza una solicitud de transacción.

Otros eventos de plataforma

Dialogflow también es compatible con eventos de otras plataformas, como la solicitud de ubicación de Facebook, los comandos de barra de Telegram y las notificaciones cuando se reciben mensajes MMS de Twilio.

Plataforma Evento Descripción
Facebook FACEBOOK_LOCATION Se activa cuando un usuario acepta/rechaza tu solicitud de ubicación del usuario.
Telegram TELEGRAM_HELP Se activa cuando un usuario ingresa /help mientras conversa con tu bot de Telegram.
Telegram TELEGRAM_SETTINGS Se activa cuando un usuario ingresa /settings mientras conversa con tu bot de Telegram.
Twilio TWILIO_MMS_RECEIVED Se activa cuando la integración de Twilio con Dialogflow recibe un mensaje MMS para tu agente.

Ubicación de Facebook

El evento FACEBOOK_LOCATION te permite obtener una ubicación desde Facebook Messenger. Crea un intent para solicitar la ubicación con una carga útil personalizada:

{
  "facebook": {
    "text": "give me your location please",
    "quick_replies": [
      {
        "content_type": "location"
      }
    ]
  }
}

Crea otro intent para procesar la ubicación y establecer el evento en FACEBOOK_LOCATION. En el webhook, recibirás la latitud y longitud del campo originalRequest:

{
  "originalDetectIntentRequest": {
    "source": "facebook",
    "payload": {
      "postback": {
        "data": {
          "lat": 14.556761479425,
          "long": 121.05444780425
        },
        "payload": "FACEBOOK_LOCATION"
      },
      "sender": {
        "id": "1588949991188331"
      }
    }
  }
}

Si deseas obtener más información, consulta la Documentación de API de Facebook Messenger para el envío de la ubicación.

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Documentación de Dialogflow
¿Necesitas ayuda? Visita nuestra página de asistencia.