Insertar formulario de contacto en WordPress

El API de Book&Learn se puede conectar a un formulario de un sitio desarrollado con WordPress. Además de poder integrarse directamente en PHP, si usas el plugin Contact Form 7 para tus formularios es posible conectactarlo sin necesidad de escribir ningúna línea de código.

La integración funciona con un nuevo formulario o incluso con uno existente, lo único que hay que tener en cuenta son los campos que se quieren enviar. (Ver campos disponibles en Book&Learn).

Instalar plugin

El primer paso para conectar el formulario es instalar el plugin Contact form 7 TO API. Este plugin nos permitirá configurar la petición al API, una vez que se envíe el formulario.

Una vez instalado y activado el plugin, nos aparecerá una nueva pestaña donde podremos configurar la llamada al API.

Configuración del Plugin

En la pantalla de configuración necesitarás llenar los siguientes campos:

Es necesario marcar el campo Send to api ? para activar el envío de las peticiones.

Base Url

Para formar la URL necesitarás tener las variables host, agency y widgetId ([ver autenticación][autenticacion]), esta es la syntaxis:

<host>/integration/<agency>/widget/<widgetId>/sale

Ejemplo:

http://stage.masterkeyeducation.com:8080/mastekrey/integration/stage/widget/12345qwerty/sale

Input Type y Method

El formulario deberá enviarse como JSON y con el método POST

JSON Template

La plantilla permite tomar los valores del formulario y convertirlos al formato requerido por el API. Puedes ocupar el siguiente código como base y reemplazar los valores entre llaves por los nombres que usas en el formulario

{
  "client": {
    "firstName": "[field-1]",
    "lastName": "[field-2]",
    "email": "[field-3]",
    "phone": "[{\"number\":\"[field-4]\"}]"
  },
  "name": "[field-5]",
  "courseType": "[field-6]",
  "referrer": "[field-7]",
  "birthday": "[field-8]",
  "occupation": "[field-9]",
  "schoolOfOrigin": "[field-10]",
  "nationality": "[field-11]",
  "destination": [
    "[field-12]"
  ],
  "comments": "[field-13]",
  "departureDate": "[field-14]",
  "city": [field-15],
  "country": "[field-16]",
  "distributor": [field-17]
}

Los nombres de las opciones de oficinas del campo "distributor" y sus id's pueden encontrarse en el menú de Oficinas activas en tu cuenta. Es importante que tengan el mismo formato para evitar un error de sintáxis.

Sólo los campos client.firstName, client.lastName y client.email son requeridos, los demás son opcionales. Para mayor información sobre el formato y los valores aceptados en cada campus, puedes consultar el API

Este es un ejemplo del plugin ya configurado.

Confguración del Plugin

Resolver errores

Una vez que esté configurado correcatamente se podrán registrar leads en Book&Learn. Si existiera algún error el plugin permite visualizar la información que se envió en la última petición, esa información la usaremos como punto de partida para encontrar el error. Para visualizar el error necesitamos dar click en el enlace + DEBUG LOG

Errores

Es importante verificar que:

  • La URL sea correcta
  • El JSON que se está enviando no tenga errores de sintaxis
  • Si el error del servidor es 422 significa que algún valor enviado en inválido ya sea por formato o integridad de datos

results matching ""

    No results matching ""