Conectar FastComments a Zapier
La aplicación FastComments para Zapier conecta tus comentarios con miles de otras aplicaciones sin escribir código.
Úsala para publicar un mensaje en Slack cuando alguien comenta, registrar cada comentario en una hoja de cálculo, crear un
comentario a partir de una presentación de formulario, o añadir comentaristas a tu CRM. Los disparadores se activan en el momento en que ocurre algo,
porque están respaldados por webhooks en lugar de sondeo, y las acciones llaman a la API de FastComments en tu
nombre.
Esta guía asume que tienes una cuenta de FastComments. Puedes crear una aquí.
Conectar su cuenta 
Conecta tu cuenta
- En Zapier, agrega un paso de FastComments a un Zap, o abre la página de la aplicación FastComments en el Directorio de aplicaciones de Zapier.
- Elige Sign in to FastComments. Zapier solicita primero tu región: selecciona United States a menos que tu cuenta haya sido creada en la región de la UE (
eu.fastcomments.com). - Se abre una ventana de FastComments. Inicia sesión si aún no lo has hecho.
- Revisa la página de consentimiento. Muestra la aplicación Zapier, la cuenta a la que se conectará y los permisos solicitados (lectura y escritura). Elige Approve.
- Zapier almacena la conexión y la etiqueta con el nombre de tu sitio y tu nombre de usuario.
La conexión usa OAuth. No se copia ninguna clave API a Zapier, y el token que Zapier posee solo funciona para la cuenta que aprobaste.
Quién puede conectar
La persona que aprueba la conexión debe ser un API admin en la cuenta de FastComments. Los propietarios de la cuenta tienen este permiso; a otros miembros del equipo se les puede conceder en la página de Usuarios. Alguien sin él verá una página de "no tienes permiso" en lugar del formulario de consentimiento.
Conectando el sitio correcto
La página de consentimiento conecta la cuenta en la que has iniciado sesión actualmente. Si gestionas varias cuentas, cambia a la correcta desde el selector de cuentas antes de aprobar, o usa el enlace switch account en la página de consentimiento. La etiqueta de conexión en Zapier muestra el nombre del sitio, por lo que una elección incorrecta es fácil de detectar.
Revisar y revocar el acceso
Cada conexión aparece bajo Connected Apps en el panel de FastComments, con los permisos que tiene y cuándo se usó por última vez. Revocarla allí desconecta a Zapier inmediatamente; cualquier Zap que use esa conexión se detiene hasta que se vuelva a conectar. También puedes eliminar la conexión desde el lado de Zapier en My Apps.
Disparadores
Disparadores
Los disparadores inician un Zap cuando ocurre algo en FastComments. Los tres son instantáneos: FastComments entrega el evento a Zapier a través de un webhook en el momento en que ocurre. No se realiza ninguna encuesta a su cuenta y no se gastan créditos de API esperando.
| Disparador | Se activa cuando |
|---|---|
| Nuevo comentario | Se publica un comentario. Por defecto solo se activan los comentarios aprobados y que no son spam. |
| Comentario actualizado | Un comentario es editado, aprobado, votado, fijado, bloqueado o modificado de alguna otra forma. |
| Comentario eliminado | Se elimina un comentario. |
Cada disparador devuelve el comentario completo: id, URL de la página e ID de la URL, nombre y correo electrónico del comentarista, el texto del comentario como markdown y como HTML, recuentos de votos, indicadores de aprobación y spam, la configuración regional, el dominio y cualquier mención. Los campos coinciden con la carga útil del webhook documentada en Webhooks, Estructuras de datos.
Opciones
Dominio. Cada disparador tiene un filtro de dominio opcional, que enumera los dominios configurados en su cuenta. Déjelo vacío para recibir eventos de todos los dominios.
Incluir comentarios no aprobados y spam. Solo en el disparador Nuevo comentario. Los comentarios que están en espera de moderación o marcados como spam se omiten por defecto. Cuando dicho comentario se aprueba más tarde, el disparador Comentario actualizado se activa para él, de modo que un Zap que debe reaccionar a cada comentario que se vuelve visible utiliza Comentario actualizado con un filtro en el campo aprobado.
Cómo funciona la entrega
Activar un Zap crea una suscripción webhook en su cuenta, visible en la página Webhooks con la fuente API. Desactivar el Zap la elimina. Los propios límites de Zapier se aplican a cuántos eventos acepta por minuto; FastComments reintenta una entrega que falla, con un retraso creciente, y desactiva una suscripción que sigue fallando durante seis días. Una suscripción desactivada puede volver a habilitarse desde la página Webhooks, o simplemente desactive y active nuevamente el Zap para crear una nueva.
Una cuenta puede contener hasta 50 suscripciones API. Cada Zap que utiliza un disparador de FastComments usa una.
Acciones y búsquedas
Acciones y Búsquedas
Las acciones crean datos en FastComments; las búsquedas buscan datos para que un paso posterior pueda utilizarlos. Cada acción llama a la API REST de FastComments y consume los mismos créditos de API que la llamada costaría desde su propio código: un crédito por llamada a menos que se indique lo contrario.
Crear Comentario
Publica un comentario en una página.
| Field | Required | Notes |
|---|---|---|
| Page URL ID | Yes | El ID de URL que el widget de comentarios usa en la página. Los comentarios se agrupan por él. |
| Page URL | Yes | La URL completa de la página, usada en los correos de notificación. |
| Comment | Yes | El cuerpo del comentario en markdown de FastComments. |
| Commenter Name | Yes | Los nombres son únicos por correo electrónico, por lo que reutilizar un nombre con un correo diferente falla. |
| Commenter Email | No | Se crea un usuario para el correo cuando aún no existe. |
| User ID | No | Un ID de usuario SSO existente. Tiene precedencia sobre el nombre y el correo. |
| Parent Comment ID | No | Establecer para publicar una respuesta. |
| Approved, Verified | No | Ambos predeterminados a verdadero. Los comentarios no aprobados permanecen ocultos hasta ser moderados. |
| Posted At | No | Predeterminado a ahora. |
| Avatar URL, Page Title, Locale | No | El locale predeterminado es en_us. |
| Show Live In Widget | No | Envía el comentario a los espectadores en tiempo real. Cuesta 2 créditos en lugar de 1. |
| Run Spam Check, Send Emails | No | Desactivado por defecto. |
Crear Página
Crea un registro de página antes de que exista cualquier comentario en ella, de modo que pueda ser listada y restringida. Recibe el ID de URL, el título, la URL y, opcionalmente, los IDs de grupos SSO que pueden verla.
Crear Usuario SSO
Crea un usuario de inicio de sesión único. Recibe su propio ID de usuario, nombre de usuario y correo electrónico, además de nombre para mostrar opcional, etiqueta de visualización, avatar, sitio web, IDs de grupos y banderas de notificación y privacidad. Los roles administrativos no pueden concederse desde Zapier.
Crear Publicación de Feed
Crea una publicación en un feed de FastComments a partir de contenido HTML, con un título opcional, autor, etiquetas y una vista previa de enlace.
Crear Etiqueta Hash
Crea una etiqueta hash que los comentaristas pueden usar, con una URL opcional a la que enlaza.
Señalar Comentario
Marca un comentario para revisión del moderador. Proporcione el ID del usuario que realiza la señalización, o déjelo vacío para señalar como la integración de Zapier.
Búsquedas
| Search | Input | Returns |
|---|---|---|
| Find Comment | Comment ID | El comentario, o nada. |
| Find SSO User | El usuario SSO, o nada. | |
| Find Page | URL ID | La página, o nada. |
Una búsqueda que no encuentra nada no falla el Zap. Combine una búsqueda con una creación en el modo "find or create" de Zapier para crear la página o el usuario cuando falta.
Ejemplos de Zaps
Zaps de ejemplo
Algunos flujos de trabajo que se configuran en minutos.
Recibe notificaciones sobre nuevos comentarios. New Comment, then Slack "Send Channel Message" or Discord "Send Channel Message". Mapea el nombre del comentarista, el texto del comentario y la URL de la página en el mensaje. Añade el filtro de dominio para notificar a un canal diferente por sitio.
Mantén un registro de cada comentario. New Comment, then Google Sheets "Create Spreadsheet Row". Añade Deleted Comment como un segundo Zap que agrega una fila con el id del comentario, de modo que la hoja también sirve como registro de auditoría.
Envía un correo electrónico al autor cuando se aprueba un comentario. Updated Comment con un filtro de Zapier donde Approved es true, then Gmail "Send Email". Debido a que Updated Comment se dispara en cada cambio, el filtro es lo que hace que este Zap reaccione solo a aprobaciones.
Añade a los comentaristas a tu CRM o lista de correo. New Comment, then HubSpot "Create or Update Contact" or Mailchimp "Add or Update Subscriber" usando el correo electrónico del comentarista. Respeta tu política de privacidad y la legislación local antes de añadir a alguien a una lista de marketing.
Crea un comentario a partir de un formulario. Typeform or Google Forms "New Response", then FastComments Create Comment con el ID de URL de página que tu sitio usa para testimonios. Deja Approved sin marcar para revisar cada uno antes de que aparezca.
Publica anuncios en un feed. RSS by Zapier "New Item in Feed", then Create Feed Post con el título, contenido y enlace del elemento.
Provee a los miembros como usuarios SSO. Memberstack, Memberful, o tu propio webhook, then Find SSO User seguido de Create SSO User en modo "find or create".
Escala los comentarios reportados. Updated Comment, filtrado con un recuento de flags superior a cero, then Trello "Create Card" or Linear "Create Issue" con el id del comentario y un enlace a la página de moderación.
Publica páginas a medida que se ponen en línea. WordPress or Ghost "New Post", then Create Page con la URL de la publicación, de modo que la página se liste y restrinja antes del primer comentario.
Archiva los comentarios eliminados. Deleted Comment, then Airtable "Create Record" con el comentario completo para retención de cumplimiento.
Solución de problemas
Solución de problemas
"No tienes permiso" al conectar. El usuario conectado no es un administrador API en la cuenta.
Pídele al propietario de la cuenta que conceda el permiso API en la página de Usuarios, o conéctate como el propietario.
La conexión está etiquetada con el sitio incorrecto. La página de consentimiento conecta la cuenta con la que iniciaste
sesión en ese momento. Desconecta en Zapier, cambia de cuenta en el panel de FastComments y vuelve a conectar.
Los eventos dejaron de llegar. Revisa la página de Webhooks en el panel. Una suscripción cuyo endpoint siguió
fallando durante seis días se desactiva automáticamente y muestra la razón. Vuelve a habilitarla allí, o apaga y enciende
el Zap nuevamente. Si la suscripción falta por completo, alguien la eliminó; apagar y encender el Zap la recrea.
Zapier indica que la cuenta necesita reconectarse. La conexión fue revocada desde la página de Aplicaciones Conectadas
y el usuario que la aprobó perdió el permiso API, o la cuenta fue eliminada. Reconecta desde Zapier.
Una acción falla con "no tiene acceso de escritura". La conexión se aprobó con permiso de solo lectura
y necesita ambos permisos. Reconecta y aprueba ambos permisos.
Límites de velocidad y créditos. Las acciones y búsquedas consumen créditos API de tu plan y están sujetas a los
mismos límites de velocidad que la API REST. Los disparadores no consumen ninguno. Un Zap que alcanza un límite se reintenta por Zapier
después del retraso que informa FastComments.
El menú desplegable de Dominio está vacío. Los dominios aparecen una vez que se configuran en la página de Dominios en el
panel de FastComments. Deja el campo vacío para recibir eventos de todos los dominios.