{"id":18833,"date":"2022-11-29T22:49:31","date_gmt":"2022-11-29T19:49:31","guid":{"rendered":"https:\/\/snov.io\/knowledgebase\/?p=18833"},"modified":"2026-01-23T20:53:31","modified_gmt":"2026-01-23T17:53:31","slug":"como-usar-los-webhooks-de-snov-io","status":"publish","type":"post","link":"https:\/\/snov.io\/knowledgebase\/es\/como-usar-los-webhooks-de-snov-io\/","title":{"rendered":"C\u00f3mo configurar webhooks mediante la API de Snov.io"},"content":{"rendered":"

En este art\u00edculo aprender\u00e1s c\u00f3mo configurar y administrar webhooks a trav\u00e9s de la API de Snov.io para tus integraciones personalizadas.<\/p>\n

\u00bfQu\u00e9 es un webhook?<\/strong><\/h2>\n

Los webhooks te permiten recibir notificaciones sobre eventos que ocurren en tus campa\u00f1as, como respuestas de prospectos o la finalizaci\u00f3n de una campa\u00f1a.<\/p>\n

Cuando se produce el evento al que te suscribiste, Snov.io env\u00eda en tiempo real los datos relacionados con ese evento a tu endpoint (URL del webhook). Puedes usar estos datos para integraciones o automatizaciones mediante aplicaciones como Zapier o Make.<\/p>\n

\n
\"note\"<\/div>\n
Los webhooks requieren un plan de pago de Snov.io (premium). Puedes crear hasta 50 webhooks.<\/div>\n<\/div>\n

C\u00f3mo crear webhooks<\/strong><\/h2>\n
\n

Para suscribirte a webhooks, elige el evento que deseas rastrear, prepara la URL de tu endpoint y env\u00eda una solicitud a la API de Snov.io.<\/p>\n<\/div>\n

Elige el evento<\/strong><\/h3>\n

Decide qu\u00e9 evento deseas rastrear de la lista de eventos compatibles.<\/p>\n

Cuando ocurra el evento seleccionado, Snov.io enviar\u00e1 autom\u00e1ticamente los datos del evento a tu endpoint.<\/p>\n

A continuaci\u00f3n se muestran los eventos de webhook compatibles actualmente. Por ejemplo, puedes recibir datos cuando un prospecto responde a un correo de campa\u00f1a, cuando un email rebota o cuando un prospecto completa una campa\u00f1a.<\/p>\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Objeto del webhook(event_object)<\/em><\/th>\nAcci\u00f3n (event_action)<\/em><\/th>\nCu\u00e1ndo se activa<\/th>\n<\/tr>\n<\/thead>\n
campaign_email<\/td>\nsent<\/td>\nCuando se env\u00eda cualquier correo a un destinatario en cualquier campa\u00f1a<\/td>\n<\/tr>\n
campaign_email<\/td>\nfirst_sent<\/td>\nCuando se env\u00eda el primer correo a un destinatario en cualquier campa\u00f1a<\/td>\n<\/tr>\n
campaign_email<\/td>\nopened<\/td>\nCuando un destinatario abre cualquier correo de una campa\u00f1a<\/td>\n<\/tr>\n
campaign_email<\/td>\nbounced<\/td>\nCuando un correo enviado desde una campa\u00f1a no puede entregarse y genera un rebote<\/td>\n<\/tr>\n
campaign_reply<\/td>\nreceived<\/td>\nCuando un destinatario responde a cualquier correo en cualquier campa\u00f1a<\/td>\n<\/tr>\n
campaign_reply<\/td>\nfirst_received<\/td>\nCuando un destinatario responde por primera vez a un correo de campa\u00f1a<\/td>\n<\/tr>\n
prospect<\/td>\ncampaign_finished<\/td>\nCuando un prospecto llega al final de una campa\u00f1a y no hay m\u00e1s pasos programados<\/td>\n<\/tr>\n
company<\/td>\nfound_domains_by_names<\/td>\nCuando se encuentra el dominio de una empresa a partir de su nombre<\/td>\n<\/tr>\n
prospect<\/td>\nfound_by_li_url<\/td>\nCuando se encuentra el perfil de un prospecto a partir de una URL de LinkedIn<\/td>\n<\/tr>\n
email_verification<\/td>\nverified<\/td>\nCuando se completa una solicitud de verificaci\u00f3n de correo electr\u00f3nico<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
\n
\n

Prepara la URL de tu endpoint<\/strong><\/h3>\n

Esta es tu propia URL p\u00fablica que puede aceptar solicitudes HTTP entrantes. Por ejemplo, una URL de webhook en Zapier\/Make o el endpoint de tu aplicaci\u00f3n.<\/p>\n

Env\u00eda la solicitud para crear el webhook<\/strong><\/h3>\n

Para crear un webhook en tu cuenta de Snov.io, utiliza el endpoint Add webhook<\/a> de la API de Snov.io.<\/p>\n

\n
\"learn\"<\/div>\n
Puedes suscribirte y gestionar webhooks mediante un conjunto de llamadas a la API. Consulta la documentaci\u00f3n de la API<\/a> para conocer todos los detalles.<\/div>\n<\/div>\n

Env\u00eda una solicitud a la API con los siguientes par\u00e1metros. Los par\u00e1metros del webhook est\u00e1n predefinidos seg\u00fan el tipo de evento que deseas rastrear.<\/p>\n

    \n
  • M\u00e9todo: POST<\/li>\n
  • URL de la solicitud: https:\/\/api.snov.io\/v2\/webhooks<\/li>\n<\/ul>\n

    Par\u00e1metros del webhook<\/strong><\/h3>\n
      \n
    • event_object \u2014<\/strong> qu\u00e9 deseas rastrear, como prospecto o correo (copia los valores correspondientes de la tabla anterior)<\/li>\n
    • event_action<\/strong> \u2014 el evento espec\u00edfico que debe ocurrir para que el webhook se active (copia los valores correspondientes de la tabla anterior)<\/li>\n
    • endpoint_url<\/strong> \u2014 proporciona tu propia URL p\u00fablica donde Snov.io enviar\u00e1 los datos<\/li>\n<\/ul>\n

      Para crear un webhook de respuestas de prospectos (cuando un destinatario responde a cualquier correo en cualquier campa\u00f1a), elige estos par\u00e1metros:<\/p>\n

        \n
      • event_object: campaign_reply<\/li>\n
      • event_action: received<\/li>\n<\/ul>\n
        \n
        \n

        Ejemplo del cuerpo de la solicitud a la API:<\/strong><\/p>\n

        { \"event_object\": \"campaign_reply\", \"event_action\": \"received\", \"endpoint_url\": \"https:\/\/your-domain.com\/webhooks\/snov-replies\" }<\/em><\/p>\n<\/div>\n<\/div>\n

        Verifica que el webhook funcione correctamente<\/strong><\/h3>\n

        Despu\u00e9s de crear el webhook:<\/p>\n

          \n
        • Aseg\u00farate de que tu endpoint devuelva un estado HTTP 200\u2013299 en un plazo de 3 segundos.<\/li>\n
        • \n

          Si el endpoint devuelve un estado diferente (o se agota el tiempo), Snov.io reintenta enviar el webhook autom\u00e1ticamente.<\/p>\n<\/li>\n<\/ul>\n<\/div>\n<\/div>\n

          \n
          \"learn\"<\/div>\n
          \n

          Pol\u00edtica de reintentos: El comportamiento a continuaci\u00f3n refleja c\u00f3mo Snov.io entrega los eventos de webhook en la pr\u00e1ctica.
          \n<\/strong><\/p>\n

           <\/p>\n

          El webhook se considera exitoso si Snov.io recibe un estado HTTP en el rango 200\u2013299 dentro de los 3 segundos.<\/p>\n

          Si se recibe cualquier otro estado HTTP o se produce un timeout, se realizan siete intentos de reenv\u00edo con intervalos crecientes, hasta 38 horas despu\u00e9s del evento que activ\u00f3 el webhook. Si todos los reintentos fallan, el webhook se desactiva:<\/p>\n

            \n
          • 1.\u00ba: inmediatamente despu\u00e9s del evento<\/li>\n
          • 2.\u00ba: 20 minutos despu\u00e9s del \u00faltimo intento (20 minutos despu\u00e9s del evento)<\/li>\n
          • 3.\u00ba: 40 minutos despu\u00e9s del \u00faltimo intento (1 hora despu\u00e9s del evento)<\/li>\n
          • 4.\u00ba: 60 minutos despu\u00e9s del \u00faltimo intento (2 horas despu\u00e9s del evento)<\/li>\n
          • 5.\u00ba: 4 horas despu\u00e9s del \u00faltimo intento (6 horas despu\u00e9s del evento)<\/li>\n
          • 6.\u00ba: 8 horas despu\u00e9s del \u00faltimo intento (14 horas despu\u00e9s del evento)<\/li>\n
          • 7.\u00ba: 24 horas despu\u00e9s del \u00faltimo intento (38 horas despu\u00e9s del evento)<\/li>\n<\/ul>\n<\/div>\n<\/div>\n","protected":false},"excerpt":{"rendered":"

            En este art\u00edculo aprender\u00e1s c\u00f3mo configurar y administrar webhooks a trav\u00e9s de la API de Snov.io para tus integraciones personalizadas. \u00bfQu\u00e9 es un webhook? Los webhooks te permiten recibir notificaciones sobre eventos que ocurren en tus campa\u00f1as, como respuestas de prospectos o la finalizaci\u00f3n de una campa\u00f1a. Cuando se produce el evento al que te […]<\/p>\n","protected":false},"author":20,"featured_media":0,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2206],"tags":[],"_links":{"self":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/18833"}],"collection":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/users\/20"}],"replies":[{"embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/comments?post=18833"}],"version-history":[{"count":4,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/18833\/revisions"}],"predecessor-version":[{"id":44485,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/posts\/18833\/revisions\/44485"}],"wp:attachment":[{"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/media?parent=18833"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/categories?post=18833"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/snov.io\/knowledgebase\/wp-json\/wp\/v2\/tags?post=18833"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}