Integrar Formulario de Contacto

Bitdesk permite que los formularios de contacto de sus sitio web generen tickets en lugar de generar correos electrónicos a los cuales posiblemente no se les de un seguimiento adecuando. En este documento se detalla como prepara su formaulrio de contacto para que genre tickets en Bitdesk.

El proceso es sencillo y solo requiere adecuaciones a nivel de HTML pero sin necesidad de modificaciones en los sistemas Backend.

Configuración de Tag Form

  1. En el HTML del formulario cambiar el valor del atributo action del tag form por la url del API: https://tickets.bitworks.com.sv/CreacionManualTickets/CrearTicket.  

  2. Asegurarse que el formulario funcione con method=”POST”

Ejemplo de Tag Form Correcto
<form action=" https://tickets.bitworks.com.sv/CreacionManualTickets/CrearTicket" method=”POST”>

Preparar los Controles del Formulario

  1. Proporcionar a Bitworks la lista de campos del formulario con el valor del atributo name  de cada uno, para configurar los campos en Bitdesk.

  2. Agregar los siguientes campos extra al formulario como controles de tipo hidden, algunos de los valores de estos campos serán proporcionados por Bitworks:

    1. bitworks_direct_form: Debe asignarse el valor del identificador del formulario, este dato se les proporcionará una vez nos se envíe la información de los capos del formulario detallados en el numeral 1.
    2. bitworks_ch: Debe asignársele valor cero “0”.
    3. bitworks_sms: Debe asignársele de  valor  un  guion “-”
    4. ReturnUrl: es la url a la que se  redireccionara luego de completado el proceso de creación del ticket. Esta tiene que ser una URL absoluta, ejemplo:
Ejemplo de Tags
<input type="hidden" name=" bitworks_ch" value="0"/>
<input type="hidden" name="ReturnUrl" value="http://www.sudominio.com/confirmacionContecto"/>

Implementar Recpatcha

Es necesario agregar al formulario que se enviara a Bitdesk un control reCaptcha de google, para ello hacer estos pasos:

  • Dentro del tag <head>  de la página del foormualrio agregar este script
Script de Recaptcha
<script src="https://www.google.com/recaptcha/api.js" async defer></script>
  • Luego colocar este <div>  en el área de su formulario (dentro en algun lugar dentro del tag <form>)  donde desea que el recaptcha se redederice:
div Recapcha
<div class="g-recaptcha" data-sitekey=”6Lee1V0UAAAAAIRby99VfT1evwOgYzXboOe2f-o5”></div>
Se debe Indicar a Bitworks todos los dominios donde tiene formularios que integrara con el sistema de tickets