Este documento ofrece una guía de buenas prácticas desde la creación hasta la implementación y manejo de webhooks, asegurando un funcionamiento eficiente y seguro de estos componentes críticos para la integración de servicios.
Validación de Request: Asegure la autenticidad y la integridad de los requests mediante la verificación de firmas digitales, como HMAC.
HTTPS: Utilice siempre HTTPS para la transmisión de datos, protegiendo la información sensible.
Eficiencia
Intentos de Reintento: Implemente lógicas de reintento con políticas de backoff exponencial para manejar fallos de entrega.
Implementación del Servidor
Manejo de Cargas
Asincronía: Procese los webhooks de manera asincrónica para evitar bloqueos y asegurar una respuesta rápida al emisor.
Escalabilidad: Diseñe su sistema para ser escalable, capaz de manejar picos de actividad sin degradación del servicio.
Seguridad
Verificación de Firmas: Implemente y verifique firmas HMAC para confirmar la autenticidad del emisor.
Limitación de IP: Restrinja las solicitudes a rangos de IP conocidos cuando sea posible.
Robustez
Validación de Datos: Realice una validación rigurosa de los datos recibidos para evitar inyecciones SQL y otros ataques.
Manejo de Errores: Implemente un manejo de errores exhaustivo para cubrir posibles fallos y asegurar una respuesta adecuada.
Procesamiento de Webhooks
Recepción y Respuesta
Respuestas Rápidas: Asegure que su endpoint de webhook responda rápidamente, idealmente con un código de estado HTTP 200, para confirmar la recepción.
Logística de Procesamiento
Colas de Mensajes: Utilice colas de mensajes para procesar los webhooks de forma eficiente y en orden.
Monitoreo y Alertas: Establezca sistemas de monitoreo y alertas para rastrear fallos, latencias y volúmenes anómalos.
Pruebas y Mantenimiento
Pruebas Rigurosas
Automatización de Pruebas: Desarrolle pruebas automatizadas para su lógica de webhooks, incluyendo la verificación de firmas y el manejo de errores.
Documentación
Documente Ampliamente: Provea documentación clara y completa para los consumidores de su webhook, incluyendo detalles de eventos, payloads esperados y ejemplos de código.
La implementación de estas buenas prácticas no solo mejora la seguridad y eficiencia de sus
webhooks sino que también facilita una mejor integración y experiencia para los consumidores de su
API.
Mantenga siempre una postura de seguridad proactiva, actualizando y revisando sus prácticas
conforme evolucionan las amenazas y las tecnologías.
{"docsConfig":{"$schema":"https://mintlify.com/docs.json","theme":"mint","name":"Kausanna API","colors":{"primary":"#fd4f00","light":"#efe2d2","dark":"#0e0e0e"},"favicon":"/favicon.svg","logo":{"light":"https://i.ibb.co/nRLXdmb/logo-color-black.png","dark":"https://i.ibb.co/HHWM3Kk/logo-color.png"},"api":{"openapi":"api-reference/openapi/openapi-complete.yaml"},"navbar":{"links":[{"label":"Soporte","href":"mailto:[email protected]"}],"primary":null},"search":{"prompt":"Buscar en la documentación"},"footer":{"socials":{"twitter":"https://twitter.com/naranjax","linkedin":"https://www.linkedin.com/company/naranjax"}},"navigation":{"global":{"anchors":[{"anchor":"Documentación","href":"https://docs-kausanna.sonqo.io/api-reference","icon":"book-open-cover"},{"anchor":"Comunidad de Slack","href":"https://naranjax.slack.com/","icon":"slack"},{"anchor":"Changelog","href":"https://docs-kausanna.sonqo.io/changelog","icon":"timeline"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"naranjax","hasAudioNarration":false,"actualSubdomain":"naranjax","customDomains":["docs-kausanna.sonqo.io"],"gitSource":{"type":"github","owner":"byeze","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"REMOVE_BRANDING":{"status":"ENABLED"}},"buildId":"6ae91eebabde022f2c1f050d:success","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"API Reference","count":18},{"language":"default","tag":"Documentación","count":16},{"language":"default","tag":"Claims","count":8},{"language":"default","tag":"Webhooks","count":8},{"language":"default","tag":"Disputas","count":7},{"language":"default","tag":"Empezando","count":4},{"language":"default","tag":"Documentación de claim","count":3},{"language":"default","tag":"Utilidades","count":2},{"language":"default","tag":"Documentación API","count":1},{"language":"default","tag":"Changelog","count":1}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"webhooks/good-practices","slug":"/webhooks/good-practices","pageMetadata":{"title":"Buenas Prácticas para Webhooks","description":null,"href":"/webhooks/good-practices"},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Tip,Warning}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Tip)_missingMdxReference(`Tip`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Este documento ofrece una guía de buenas prácticas desde la creación hasta la implementación y manejo de webhooks, asegurando un funcionamiento eficiente y seguro de estos componentes críticos para la integración de servicios.`}),`\n`,_jsx(Heading,{level:`2`,id:`diseño`,children:`Diseño`}),`\n`,_jsx(Heading,{level:`3`,id:`definición-clara-de-eventos`,children:`Definición Clara de Eventos`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Especifique claramente`}),` qué eventos usted desea recibir.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`seguridad`,children:`Seguridad`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Validación de Request`}),`: Asegure la autenticidad y la integridad de los requests mediante la verificación de firmas digitales, como HMAC.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`HTTPS`}),`: Utilice siempre HTTPS para la transmisión de datos, protegiendo la información sensible.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`eficiencia`,children:`Eficiencia`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Intentos de Reintento`}),`: Implemente lógicas de reintento con políticas de backoff exponencial para manejar fallos de entrega.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`implementación-del-servidor`,children:`Implementación del Servidor`}),`\n`,_jsx(Heading,{level:`3`,id:`manejo-de-cargas`,children:`Manejo de Cargas`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Asincronía`}),`: Procese los webhooks de manera asincrónica para evitar bloqueos y asegurar una respuesta rápida al emisor.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Escalabilidad`}),`: Diseñe su sistema para ser escalable, capaz de manejar picos de actividad sin degradación del servicio.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`seguridad-2`,children:`Seguridad`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Verificación de Firmas`}),`: Implemente y verifique firmas HMAC para confirmar la autenticidad del emisor.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Limitación de IP`}),`: Restrinja las solicitudes a rangos de IP conocidos cuando sea posible.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`robustez`,children:`Robustez`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Validación de Datos`}),`: Realice una validación rigurosa de los datos recibidos para evitar inyecciones SQL y otros ataques.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Manejo de Errores`}),`: Implemente un manejo de errores exhaustivo para cubrir posibles fallos y asegurar una respuesta adecuada.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`procesamiento-de-webhooks`,children:`Procesamiento de Webhooks`}),`\n`,_jsx(Heading,{level:`3`,id:`recepción-y-respuesta`,children:`Recepción y Respuesta`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Respuestas Rápidas`}),`: Asegure que su endpoint de webhook responda rápidamente, idealmente con un código de estado HTTP 200, para confirmar la recepción.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`logística-de-procesamiento`,children:`Logística de Procesamiento`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Colas de Mensajes`}),`: Utilice colas de mensajes para procesar los webhooks de forma eficiente y en orden.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Monitoreo y Alertas`}),`: Establezca sistemas de monitoreo y alertas para rastrear fallos, latencias y volúmenes anómalos.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`2`,id:`pruebas-y-mantenimiento`,children:`Pruebas y Mantenimiento`}),`\n`,_jsx(Heading,{level:`3`,id:`pruebas-rigurosas`,children:`Pruebas Rigurosas`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Automatización de Pruebas`}),`: Desarrolle pruebas automatizadas para su lógica de webhooks, incluyendo la verificación de firmas y el manejo de errores.`]}),`\n`]}),`\n`,_jsx(Heading,{level:`3`,id:`documentación`,children:`Documentación`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Documente Ampliamente`}),`: Provea documentación clara y completa para los consumidores de su webhook, incluyendo detalles de eventos, payloads esperados y ejemplos de código.`]}),`\n`]}),`\n`,_jsx(Tip,{children:_jsx(_components.p,{children:`La implementación de estas buenas prácticas no solo mejora la seguridad y eficiencia de sus\nwebhooks sino que también facilita una mejor integración y experiencia para los consumidores de su\nAPI.`})}),`\n`,_jsx(Warning,{children:_jsx(_components.p,{children:`Mantenga siempre una postura de seguridad proactiva, actualizando y revisando sus prácticas\nconforme evolucionan las amenazas y las tecnologías.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Buenas Prácticas para Webhooks","description":null,"href":"/webhooks/good-practices"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Diseño","slug":"diseño","depth":2,"children":[{"title":"Definición Clara de Eventos","slug":"definición-clara-de-eventos","depth":3,"children":[]},{"title":"Seguridad","slug":"seguridad","depth":3,"children":[]},{"title":"Eficiencia","slug":"eficiencia","depth":3,"children":[]}]},{"title":"Implementación del Servidor","slug":"implementación-del-servidor","depth":2,"children":[{"title":"Manejo de Cargas","slug":"manejo-de-cargas","depth":3,"children":[]},{"title":"Seguridad","slug":"seguridad-2","depth":3,"children":[]},{"title":"Robustez","slug":"robustez","depth":3,"children":[]}]},{"title":"Procesamiento de Webhooks","slug":"procesamiento-de-webhooks","depth":2,"children":[{"title":"Recepción y Respuesta","slug":"recepción-y-respuesta","depth":3,"children":[]},{"title":"Logística de Procesamiento","slug":"logística-de-procesamiento","depth":3,"children":[]}]},{"title":"Pruebas y Mantenimiento","slug":"pruebas-y-mantenimiento","depth":2,"children":[{"title":"Pruebas Rigurosas","slug":"pruebas-rigurosas","depth":3,"children":[]},{"title":"Documentación","slug":"documentación","depth":3,"children":[]}]}],"codeExamples":{}},"jsLinks":[],"subdomain":"naranjax","siteName":"Kausanna API","title":"Buenas Prácticas para Webhooks - Kausanna API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"webhooks/good-practices.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"application-name\" content=\"Kausanna API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/naranjax/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/naranjax/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/naranjax/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/naranjax/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Buenas Prácticas para Webhooks - Kausanna API\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Kausanna API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs-kausanna.sonqo.io/webhooks/good-practices\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://naranjax.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Buenas+Pr%C3%A1cticas+para+Webhooks\u0026amp;theme=79af4ce82463cd99e2415952\u0026amp;signature=d21c81ece2f0dcf97ff804d2a1007194afb75e066e1a1e7bf29816fee10e90c0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Buenas Prácticas para Webhooks - Kausanna API\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://naranjax.mintlify.site/_mintlify/api/og/v2?division=Webhooks\u0026amp;title=Buenas+Pr%C3%A1cticas+para+Webhooks\u0026amp;theme=79af4ce82463cd99e2415952\u0026amp;signature=d21c81ece2f0dcf97ff804d2a1007194afb75e066e1a1e7bf29816fee10e90c0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"https://mintlify.s3.us-west-1.amazonaws.com/naranjax/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Kausanna API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#fd4f00\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs-kausanna.sonqo.io/webhooks/good-practices\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/webhooks/good-practices.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs-kausanna.sonqo.io/#organization\",\"name\":\"Kausanna API\",\"url\":\"https://docs-kausanna.sonqo.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://i.ibb.co/nRLXdmb/logo-color-black.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs-kausanna.sonqo.io#website\",\"name\":\"Kausanna API\",\"url\":\"https://docs-kausanna.sonqo.io\",\"publisher\":{\"@id\":\"https://docs-kausanna.sonqo.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices#webpage\",\"url\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices\",\"name\":\"Buenas Prácticas para Webhooks\",\"isPartOf\":{\"@id\":\"https://docs-kausanna.sonqo.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Webhooks\",\"item\":\"https://docs-kausanna.sonqo.io/webhooks/quickstart\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Buenas Prácticas para Webhooks\",\"item\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices#article\",\"headline\":\"Buenas Prácticas para Webhooks\",\"name\":\"Buenas Prácticas para Webhooks\",\"url\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices\",\"mainEntityOfPage\":{\"@id\":\"https://docs-kausanna.sonqo.io/webhooks/good-practices#webpage\"},\"publisher\":{\"@id\":\"https://docs-kausanna.sonqo.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs-kausanna.sonqo.io#website\"}}]}\u003c/script>","agentPointerHref":"/webhooks/good-practices.md","siteName":"Kausanna API","nav":{"global":{"anchors":[{"anchor":"Documentación","href":"https://docs-kausanna.sonqo.io/api-reference","icon":"book-open-cover"},{"anchor":"Comunidad de Slack","href":"https://naranjax.slack.com/","icon":"slack"},{"anchor":"Changelog","href":"https://docs-kausanna.sonqo.io/changelog","icon":"timeline"}]},"tabs":[{"tab":"Documentación","groups":[{"group":"Empezando","pages":[{"title":"Introducción","href":"/introduction"},{"title":"Checklist","href":"/quickstart"},{"title":"Medición de Consumo de API","href":"/usage"},{"title":"Redes soportadas","href":"/networks"}]},{"group":"Disputas","pages":[{"title":"Cómo Funcionan las Disputas","href":"/disputes/how-it-works"},{"title":"Listas de Comerciantes de Alto Riesgo","href":"/disputes/match-list"},{"title":"Proceso de Disputa de Tarjeta de Crédito para Adquirentes","href":"/disputes/about"},{"title":"Tipos de evidencias","href":"/disputes/evidence"},{"title":"Análisis de evidencias en disputas","href":"/disputes/evidence-process"},{"title":"Glosario de Términos","href":"/disputes/glossary"},{"title":"Estados de Claims","href":"/disputes/status"}]},{"group":"Webhooks","pages":[{"title":"Creación y Uso de Webhooks en Kausanna","href":"/webhooks/quickstart"},{"title":"Verificación de Webhooks mediante HMAC en Kausanna","description":null,"href":"/webhooks/security-hmac"},{"title":"Buenas Prácticas para Webhooks","href":"/webhooks/good-practices"},{"title":"El objeto evento","description":"Conoce el objeto evento y cómo utilizarlo en tu integración","href":"/webhooks/events"}]},{"group":"Changelog","pages":[{"title":"Changelog","href":"/changelog"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/api-reference/introduction"}]}]},"basePath":"","title":"Buenas Prácticas para Webhooks - Kausanna API","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":[],"chunks":[]}