Solicitud de datos

Cómo capturar datos del clientes con el chatbot

Muchas veces es necesario solicitar y guardar ciertos datos de los clientes. Para esto se utiliza el tipo de acción data-collect y los key correspondientes:

Ejemplos:

Nombre

<action 
type="data-collect"   
key="customer.name"    
ignore_if_exists="ignore_if_exists"    
with_text="¿Cuál es tu nombre?"    
validation="regex"    
validation_pattern="^.{3,20}$"    
validation_error="Pareciera que ingresaste un nombre inválido. ¿Podrías volver a intentar?"
/>

E-mail

<action    
type="data-collect"    
key="customer.email"    
ignore_if_exists="ignore_if_exists"    
with_text="¿Cuál es su correo electrónico?"    
validation="regex"    
validation_pattern="[^@\s]+@[^@\s]+\.[^@\s.]+$"    
validation_error="{email_error}"
/>

Ciudad y pais

<action      
type="data-collect"      
key="customer.location"      
ignore_if_exists="ignore_if_exists"      
with_text="¿En que país/ciudad esta viviendo?" 
/>

Otros datos

Se utiliza el key: key="customer.extra_fields.X", donde X describirá el dato

<action type="data-collect" 
key="customer.extra_fields.dni" 
with_text="¿Cual es tu dni?" 
ignore_if_exists="ignore_if_exists" 
/>

El comando ignore_if_exists="ignore_if_exists" sirve para no volver a pedirle el dato al cliente la próxima vez que escriba.

OBTENCIÓN DE OPT-IN

Hay dos modos de configurar el pedido de autorización para recibir notificaciones de la empresa por whasapp:

• Por única vez independientemente de la respuesta del cliente

• Por cada contacto del cliente en caso de que haya respondido que "No"

Única vez

<branches switch="customer.whatsapp_opt_in">    
 <branch cases="[False, None]">        
  <options header="¿Aceptas recibir notificaciones por Whatsapp?            
   
   <option text="Sí">                
   <action type="store" key="customer.whatsapp_opt_in" value="True" cast="cast"/>                
   <action type="hand-over" chat_group="ventas"/>             
   </option>            

   <option text="No">                
   <action type="store" key="customer.whatsapp_opt_in" value="False" cast="cast"/>                
   <action type="hand-over" chat_group="ventas"/>             
   </option>        
  </options>    
 </branch>   
  
<branch cases="[True]">      
 <action type="hand-over" chat_group="ventas"/>     
</branch>

</branches>

Reiterar por respuesta negativa

<branches switch="customer.extra_data.one_time_whatsapp_opt_in">    
 
 <branch cases="[False, None]">        
 <options header="¿Aceptas recibir notificaciones por Whatsapp?            

 <option text="Sí">                
  <action type="store" key="customer.extra_data.one_time_whatsapp_opt_in" value="True" cast="cast"/>                
  <action type="store" key="customer.extra_fields.one_time_whatsapp_opt_in" value="True" cast="cast"/>                
  <action type="hand-over" chat_group="ventas"/>             
 </option>            

 <option text="No">                
  <action type="store" key="customer.extra_data.one_time_whatsapp_opt_in" value="False" cast="cast"/>                
  <action type="store" key="customer.extra_fields.one_time_whatsapp_opt_in" value="True" cast="cast"/>                
  <action type="hand-over" chat_group="ventas"/>             
 </option>        
 </options>    
</branch>    

 <branch cases="[True]">      
  <action type="hand-over" chat_group="ventas"/>     
 </branch>
 </branches>

UTILIZACIÓN DE DATOS RECOLECTADOS

El dato recolectado se guarda dentro del CRM de Optiwe y puede utilizarse dentro de la misma conversación: <action type="reply" with_text="Hola {{customer.name}},_________"/>

Ejemplo de como se utilza esta acción, dentro de un menu de opciones básico:

<?xml version="1.0" encoding="utf-8"?>
<root>
   <action        
   type="data-collect"        
   key="customer.name"        
   ignore_if_exists="ignore_if_exists"        
   with_text="¿Cuál es tu nombre? "        
   validation="regex"        
   validation_pattern="^.{3,20}$"        
   validation_error="Pareciera que ingresaste un nombre inválido. ¿Podrías volver a intentar?/>      <options header="¿Con cual de estas opciones te puedo ayudar? Seleccioná la opción escribiendo el número correspondiente👇">
        
  <option text="Ventas">            
   <action type="reply" with_text="Hola {{customer.name}}, como te podemos ayudar?"/>        
   </option> 
            
   <option text="Soporte">            
   ...        
   </option>
          
 </options>
 </root>