1. Home
  2. FAQs
General
Gupshup, being on of of the trusted partners of WhatsApp, has created a self-serve portal which enables medium and large enterprises to enable WhatsApp for their respective businesses on a specific phone number, through which the businesses can communicate with their customers and vice-versa.

Gupshup provides 2 kinds of tools for WhatsApp business messaging - Customer Support and Access API, Here are the differences-

Customer Support:

Customer support tool is a user interface used by businesses to answer customer support queries seamlessly over WhatsApp with the help of multiple support agents.

Capabilities provided by Gupshup customer support dashboard -

  • Enable support team to respond instantly to customer queries
  • Receive and Share rich media like document, image, audio and video with customers
  • Pre-trained responses to frequently asked customer queries can be created helping in quicker resolution
  • Keep customers engaged with automated responses for Away or BRB modes
  • Set a display name, a display picture and greeting message customized as per your business needs
  • Easily switch from automated responses to live chat conversation
  • Support on web as well as mobile

Access API:

Access API is an API used by businesses to send transactional notifications as well as send and receive messages from customers, by integrating it with your their own service or application.

Capabilities provided by Gupshup Access API-

  • Flexible REST API that you can integrate with your CRM or Customer Support platform or existing chatbot application
  • Send messages to customers using REST API
  • Support to send rich media like document, image, audio and video in response to customer's queries and only for 24 hours since customer's last sent message on WhatsApp
  • Support to send pre-approved template notifications to customers who have opted in
  • Receive messages sent by customers via webhooks
  • Receive rich media like document, image, audio and video from customers
  • Freedom to design your application as per your business requirement
With Gupshup's WhatsApp offerings, you can do 2 kinds of messaging - Session messaging (2-way) and Template messaging (HSM).
Yes you can send text notifications (template messaging) through our Access API. The same feature will be provided in Customer Support tool shortly.
Once you become a Gupshup user we credit 1$ in your WhatsApp wallet for testing. If you need more credits, you can recharge and add balance in to your WhatsApp wallet.
Click here to check pricing
No additional charges
Sandbox is the demo environment which you can use to test Gupshup features and end user's behaviour for WhatsApp Business communication. You can create an app and test it through the sandbox if you have balance in the wallet. Click here to create an app and follow the steps. Note: Sandbox is limited and users/developer using WhatsApp CS or Access API will be only able to send out text message
WhatsApp fee is a per message country-specific fee based on the destination number. WhatsApp only charges for Template messages, and not session messages. Gupshup fee, on the other hand, is a per message fee applicable for both session and template messages, including the setup & maintenance cost for the service provided.
When your app is in not live, and you have not associated any number with it, Gupshup provides you a way to test Gupshup sandbox which is a proxy WhatsApp number. When your testers try to connect with your app through any of the 5 mechanisms provided by Gupshup, they will land on the proxy number with the keyword PROXY <APPNAME>. The rest of the behaviour remains same for the end user even when your app goes live
Usecases such as transactional notifications, customer care, 2FA or user verification are allowed on WhatsApp, while marketing and promotional or subscription based messaging is strictly prohibited.
Session & Template Messaging

Business can send 2 kinds of messages to their users depending on various conditions - Session Message & Template message

Session messaging is used to reply to customer queries or messages. If a customer sends a message to the registered WhatsApp number, it is called an incoming session message. WhatsApp allows such a business to reply to this user within 24 hours of the user's last message (active users) through the same WhatsApp number and that is also called an outgoing session message. Session messages can be free text as well as media messages and need not have a defined template to be followed by the business. Businesses are charged a per session message cost for all incoming messages and all outgoing session messages
Template messaging is basically HSM (Highly Structured Messages or Template Messages) as WhatsApp calls them. Template messaging is used for sending out transactional notifications to opted-in customers. If a customer has opted-in to a business' registered WhatsApp number by any of the 5 mechanisms provided by Gupshup, they are considered opted-in users. WhatsApp allows businesses to do template messaging with such users. Template messaging must only follow text message formats pre-approved by WhatsApp (media messages not allowed). Businesses are charged a per template message cost for all outgoing template messages basis their country

Your messages get delivered to a destination number basis below conditions-

  • Whether the destination number is active/inactive
  • If a template message is being sent, whether template messaging is switched on/off
  • If a template message is being sent and if destination number is inactive, whether the number is opted in/non opted in
  • Whether wallet has substantial balance

Gupshup WhatsApp API in its initial steps asks you to switch on or switch off Template messaging.

IF TEMPLATE MESSAGING IS KEPT OFF -

  • AND IF DESTINATION NUMBER IS ACTIVE - Irrespective of whether you try to send a free-text message or a template message, it gets sent as a session message, charged accordingly.
  • AND IF DESTINATION NUMBER IS INACTIVE - The message does not get sent in this case.

IF TEMPLATE MESSAGING IS KEPT ON -

  • AND IF DESTINATION NUMBER IS ACTIVE OPTIN - Irrespective of whether you try to send a free-text message or a template message, it gets sent as a session message, charged accordingly.
  • AND IF DESTINATION NUMBER IS INACTIVE OPTIN AND MESSAGE FORMAT MATCHES A PRE APPROVED TEMPLATE - The message gets sent as a template message, charged accordingly for the respective destination country.
  • AND IF DESTINATION NUMBER IS INACTIVE OPTIN AND MESSAGE FORMAT DOES NOT MATCH TEMPLATE - The message does not get sent in this case.
  • AND IF DESTINATION NUMBER IS NOT OPTED IN - The message does not get sent in this case.
You can decide to switch it on or off from the 'Settings' page
Businesses can use any of the pre-approved templates listed by Gupshup under 'View template' under Settings. For custom template suggestions, businesses can fill the form here
User Management

There are 2 kinds of status of every user that need to be considered before businesses can message them-

  1. Based on activity and
  2. Based on opt-in

ACTIVITY BASED STATUS -

Active users:

Users who have sent a message to a business WhatsApp number within the last 24hours of the respective timeframe

Inactive users:

Users who have sent a message to a business WhatsApp number outside the last 24hours window of the respective timeframe or never sent a message

OPTIN BASED STATUS

Opted in users:

Users who have specifically opted in to receive notifications from a respective business. Businesses can get optins via any of the mechanisms provided by Gupshup.

Non-opted in users:

Users who have never opted in or opted out from receiving notifications from a respective business.

Whatsapp mandates that you must get a voluntary consent from your user to send them template notifications.
Gupshup efficiently manages your opted in users for you. You just need to get the users using any of the 5 mechanisms offered. (Refer step 2 while testing an app). You can view opt-in and activity status of the users in the 'View Users' button on Settings page of the respective app.

There are 5 mechanisms through which you can ask users to start engaging with you. You can find these on the 'Settings' page of the respective app -

1. Scan QR code

Every app created by you on the WhatsApp dashboard of Gupshup will generate a unique QR code. Your users can scan this code from your marketing collateral and land on your business WhatsApp thread.

2. Go to URL

Every app created by you on the WhatsApp dashboard of Gupshup will generate a unique WhatsApp URL. Your users can click this URL from your online marketing and land on your business WhatsApp thread.

3. Go to web widget

For every app created by you on the WhatsApp dashboard of Gupshup, you will get a unique widget code that you can embed in your web pages. Your users can click on this widget and land on your business WhatsApp thread.

In mechanism number 1, 2 and 3, Gupshup has enabled a mandatory opt-in check before they land on your WhatsApp thread.

How optin is collected once user uses the above mechanisms -
Gupshup

4. Save phone number & chat through WhatsApp directly

Your users can also save your WhatsApp phone number for live apps promoted through your marketing campaigns and get chatting with your business directly, just like any P2P chats.

In mechanism number 4, Gupshup pushes an opt-in message to the user, the first time user lands on the thread. However, the user may choose to opt in or opt out later or not opt in at all.

How optin is collected once user uses the above mechanisms -
Gupshup

5. Send SMS to given numbers

Your users can also opt in through SMS.

In mechanism number 5, the optin SMS is considered as the optin of the user, however the user may or may not become active yet.

Setup & Going Live

To make your app live, on hitting 'Go live', here is the process you will need to follow-

Checklist

You will need to make sure below items are in place before you hit 'Go live' -

  1. Verified FB Business manager account
  2. Phone number should adhere to the given guidelines here
  3. Display name should adhere to the given guidelines here
It usually takes around 2-7 days for approval from WhatsApp. You will get an email notification when all your approvals are received. If your app has not been approved even after 15 days, please write to devsupport@gupshup.io.

FB Business Manager ID is a 15 or 16-digit numeric string which can be found by logging into https://business.facebook.com with your company admin credentials.

  • Hit URL https://business.facebook.com
  • Log on to your Business account
  • Go to Business Settings (Top Right corner of the page)
  • Click on Business Info (Bottom Left corner of the page)
  • Below the Business Manager Info section you will see your Business Manager Id (Top Centre of the page)

If you do not already have a Business Manager account, you can create one from https://business.facebook.com > Create Account

Your business must use a valid phone number. Short codes are not allowed on the WhatsApp platform. The number must include a country and area code. Landline and cell phone numbers are acceptable phone numbers to use. Since a phone number is tied to a WhatsApp account, you must own this number. This phone number must be able to receive voice calls or SMS in order to complete registration. This phone number must also not have been used with the WhatsApp Business API before. Read complete guide by WhatsApp
When you add a new phone number to your WhatsApp account in the Facebook Business Manager, you assign it a display name. The display name is required to create a certificate, without which the WhatsApp Business API client will not work. Read complete guide by WhatsApp
Your Display name will show differently to your end users depending on whether your account is a Business account or Official business account. Read more
Once your app is live, go to Profile Settings on the dashboard to change your business display picture.
Yes, WhatsApp will allow to add existing WhatsApp Business/Consumer App phone number to a WABA, but won't allow to download certificate for docker setup until the phone number and associated account is deleted from the Business/Consumer app. Therefore we have not provided this provision on Gupshup's WhatsApp tools and APIs
Write to Gupshup support at devsupport@gupshup.io with subject line in the format "WhatsApp OTP issue: Phone number" along with what type of Phone number it is - Mobile, Landline, VoIP, etc
Although it totally depends on WhatsApp to reject or accept account requests, check out this official link that gives you an idea of what kind of verticals are restricted by WhatsApp
You can go live with multiple apps which will work smoothly. However, currently app-wise filtering in usage analytics and wallet statement will not be available. We will be providing this functionality shortly

You can receive such a message when the phone number you are trying to register is already active on WhatsApp business/consumer Andriod/iOS app.

Make sure you comply with following:

  1. The phone number should be never used for WhatsApp Business API and should not be active on WhatsApp Consumer/Business app(Andriod/iOS) while registering with via Gupshup
  2. If the phone number was used on the WhatsApp app (Andriod/iOS), delete the account and try again (usually it take 7 days to clear cache and then you can retry)
Access API
Access API is an API used by businesses to send transactional notifications as well as send and receive messages from customers, by integrating it with your their own service or application. On the other hand, customer support tool is a user interface used by businesses to answer customer support queries seamlessly over WhatsApp with the help of multiple support agents.
We do not offer ready plugins but you can use our API to integrate with other CRM platforms.
A callback URL can be set through App Settings on which Gupshup will forward all incoming messages.
Yes you can send notifications (template messages) to your opted-in users.

You can send the following attachments apart from Text (English and Unicode characters) -

  • Link
  • Document
    • text/csv
    • text/comma-separated-values
    • text/plain
    • application/csv
    • application/vnd.ms-excel
    • application/pdf
  • Image
    • image/png
    • image/jpeg
    • image/jpg
    • image/gif
  • Audio
    • audio/mpeg3
    • audio/x-mpeg-3
  • Video
    • video/mpeg
    • video/quicktime
    • video/mp4
    • video/mpeg
    • video/x-mpeg
Gupshup currently supports Spacing, Next line, Bold, Italics and emoticons
Yes you can receive and respond to messages for international numbers as well.
Yes, you can change it, just write to 'devsupport@gupshup.io' with following details - App Name, API Key, Registered Mobile Number.
Currently this feature is not supported on our platform
WhatsApp doesn't support sending media by byte streams

Use the below API to get the media payload:

curl -X GET \ https://api.gupshup.io/sm/api/wamedia/{WhatsApp-App-name}/{VoiceID} \ -H 'apikey: {Gupshup-Account-APIkey}'

Response type will be: application/octet-stream

You can send up to 20 messages/sec
No, the order in which the messages arrive to the end user is not guaranteed to be in the same order as they were sent
Currently this feature is not supported on our platform

An album will not be created if any of the following are met:

  • Images with captions
  • Unread divider - user sees some images, but not the rest
  • Message from user or other participants if group only
  • Date header - new day between deliveries
Refer here to get API documentation.

In a recent update, the mechanism and the structure of the API response has been changed. Meaning, whenever you will make an API call to send a message to a user - as the API response is asynchronous, the immediate response will be HTTP_SUCCESS and you will always get the response body which includes an object with message identifier and status.

Your set callback will always receive the actual status of the message as a message-event.

Hence you will receive a bulk of event messages. Please refer to the below API documentation link for your reference https://www.gupshup.io/developer/docs/bot-platform/guide/whatsapp-api-documentation#APIResponse

Currently, you will not be able to send an media messages with captions as it is not supported on our platform. However, we do have it on our roadmap and the feature should be available soon
Customer Support
Customer support tool is a user interface used by businesses to answer customer support queries seamlessly over WhatsApp with the help of multiple support agents. On the other hand, Access API is an API used by businesses to send transactional notifications as well as send and receive messages from customers, by integrating it with your their own service or application.
All the incoming messages will be visible on customer support panel.
Currently this tool only supports only session messaging initiated by the end user and does not support push notifications. However, push notifications is a feature we plan to offer very soon and we will keep you posted. (Coming Soon)
  • Text (English and Unicode characters)
  • Link
  • Document
    • text/csv
    • text/comma-separated-values
    • text/plain
    • application/csv
    • application/vnd.ms-excel
    • application/pdf
  • Image
    • image/png
    • image/jpeg
    • image/jpg
    • image/gif
  • Audio
    • audio/mpeg3
    • audio/x-mpeg-3
  • Video
    • video/mpeg
    • video/quicktime
    • video/mp4
    • video/mpeg
    • video/x-mpeg

For outgoing messages, currently we support next line (Shift+Enter); Spacing, Bold, Italics, and emoticons are currently not supported. (Coming Soon)

Formatting Symbol Example
Bold Asterisk (*) Your total is *$10.50*.
Italics Underscore (_) Welcome to _WhatsApp_!
Strike-through Tilde (~) This is ~better~ best!
Emojis Grinning Face https://emojipedia.org/whatsapp/
Agents can only send 10 messages to a single user in 24 hours, or until the user responds back. Also, there is a limit of 100000 messages an agent can send in total in 30 days.
Not only customer name but a small note describing the status of the customer can be added too.

Here are the below status you can see on the panel -

  • Responded- After an agent responds to a chat
  • Unanswered- Chat which has received BRB notification but is unattended by an agent
  • Agent responding- An agent is replying to an incoming chat
  • Notifying agent- Incoming chat which are unattended by an agent
Tags are used to identify a keyword or topic of interest and facilitate a search for it like premium customer, referral, cash of delivery, etc. This can help build a profile of your customer.
Yes you can receive and respond to messages for international numbers as well.
Currently you cannot set up non-Indian numbers for Whatsapp Customer Support, however, this feature development is in progress. It will be ready in the coming months. (Coming Soon)
No, currently you cannot associate a bot to customer support but it's on our roadmap. If you have a specific requirement in mind you can write to us at devsupport@gupshup.io.

Google Chrome: Version 45 and above

Mozilla Firefox: Version 44 and above

Yes, this can be configured in App Settings. Setup automated responses, Greeting message, Away message, Be right back (BRB).
If access to any existing WhatsApp Live chat links needs to be revoked (due to personal turnover or security issues), hit 'Refresh access' under Settings to expire ALL existing access. To then continue to use WhatsApp Live chat, use the new links generated under Settings Shortcut to your WhatsApp Customer Support tool.
A URL will be provided on which multiple users can log-in, there are no separate credentials for each individual agent.
Currently Gupshup customer support panel cannot integrate with other CRM platforms.
Yes, you can change it, just write to 'devsupport@gupshup.io' with following details - App Name, API Key, Registered Mobile Number.
Empezando
Gupshup, al ser uno de los socios de confianza de WhatsApp, ha creado un portal de autoservicio que permite a las empresas medianas y grandes habilitar WhatsApp para sus respectivas empresas en un n�mero de tel�fono espec�fico, a trav�s del cual las empresas pueden comunicarse con sus clientes y viceversa. viceversa

Gupshup ofrece 2 tipos de herramientas para la mensajer�a empresarial de WhatsApp: Soporte al cliente y acceso API. Aqu� est�n las diferencias -

Atenci�n al cliente:

La herramienta de soporte al cliente es una interfaz de usuario utilizada por las empresas para responder a las consultas de soporte al cliente a trav�s de WhatsApp con la ayuda de m�ltiples agentes de soporte.

Capacidades proporcionadas por el panel de soporte al cliente de Gupshup-

  • Permita que el equipo de soporte responda instant�neamente a las consultas de los clientes.
  • Reciba y comparta medios enriquecidos como documentos, im�genes, audio y video con los clientes
  • Se pueden crear respuestas pre-capacitadas a consultas frecuentes de los clientes para ayudar a una resoluci�n m�s r�pida
  • Mantenga a los clientes comprometidos con respuestas autom�ticas para los modos Ausente o BRB
  • Establezca un nombre para mostrar, una imagen para mostrar y un mensaje de saludo personalizado seg�n las necesidades de su empresa
  • Cambie f�cilmente de respuestas autom�ticas a conversaciones de chat en vivo
  • Soporte en la web y en dispositivos m�viles.

Acceso API:

Accesso API es una API utilizada por las empresas para enviar notificaciones transaccionales, as� como enviar y recibir mensajes de clientes, integr�ndolo con su propio servicio o aplicaci�n.

Capacidades proporcionadas por Gupshup Accesso API-

  • API REST flexible que puede integrar con su CRM o plataforma de atenci�n al cliente o aplicaci�n de chatbot existente
  • Enviar mensajes a clientes utilizando la API REST
  • Soporte para enviar medios enriquecidos como documentos, im�genes, audio y video en respuesta a las consultas del cliente y solo durante 24 horas desde el �ltimo mensaje enviado por WhatsApp
  • Soporte para enviar notificaciones de plantillas preaprobadas a clientes que han optado por
  • Recibir mensajes enviados por clientes a trav�s de webhooks
  • Reciba medios enriquecidos como documentos, im�genes, audio y video de clientes
  • Libertad para dise�ar su aplicaci�n seg�n sus requisitos comerciales
Con las ofertas de WhatsApp de Gupshup, puede hacer 2 tipos de mensajes: mensajes de sesi�n (2 v�as) y mensajes de plantilla (HSM).
S�, puede enviar notificaciones de texto (mensajes de plantilla) a trav�s de nuestra accesso API. La misma caracter�stica se proporcionar� en la herramienta de Atenci�n al Cliente en breve.
Una vez que se convierta en usuario de Gupshup, acreditaremos 1 $ en su billetera de WhatsApp para realizar pruebas. Si necesita m�s cr�ditos, puede recargar y agregar saldo a su billetera de WhatsApp.
Haga clic aqu� para consultar precios
Sin cargos adicionales
Sandbox es el entorno de demostraci�n que puede usar para probar las caracter�sticas de Gupshup y el comportamiento del usuario final para la comunicaci�n empresarial de WhatsApp. Puede crear una aplicaci�n y probarla a trav�s del sandbox si tiene saldo en la billetera. Haga clic aqu� para crear una aplicaci�n y siga los pasos. Nota: Sandbox es limitado y los usuarios / desarrolladores que usan WhatsApp CS o Accesso API solo podr�n enviar mensajes de texto
La tarifa de WhatsApp es una tarifa por mensaje espec�fica para cada pa�s, basada en el n�mero de destino. WhatsApp s�lo cobra por las plantillas de mensajes, y no por los mensajes de sesi�n. Por otro lado, la tarifa de Gupshup es una tarifa por mensaje aplicable tanto a los mensajes de sesi�n como a los de plantilla, incluyendo el coste de configuraci�n y mantenimiento del servicio proporcionado.
Cuando su aplicaci�n no est� activa y no ha asociado ning�n n�mero con ella, Gupshup le proporciona una forma de probar el sandbox de Gupshup, que es un n�mero proxy de WhatsApp. Cuando sus probadores intentan conectarse con su aplicaci�n a trav�s de cualquiera de los 5 mecanismos proporcionados por Gupshup, aterrizar�n en el n�mero de proxy con la palabra clave PROXY <APPNAME>. El resto del comportamiento sigue siendo el mismo para el usuario final, incluso cuando su aplicaci�n se activa
Casos de uso como notificaciones transaccionales, atenci�n al cliente, 2FA o verificaci�n de usuarios est�n permitidos en WhatsApp, mientras que la comercializaci�n y los mensajes promocionales o de suscripci�n est�n estrictamente prohibidos.
Mensajes de sesi�n y plantilla

Las empresas pueden enviar 2 tipos de mensajes a sus usuarios en funci�n de diversas condiciones: mensaje de sesi�n & mensaje de plantilla

La mensajer�a de sesi�n se utiliza para responder a consultas o mensajes de clientes. Si un cliente env�a un mensaje al n�mero registrado de WhatsApp, se llama un mensaje de sesi�n entrante. WhatsApp permite que dicha empresa responda a este usuario dentro de las 24 horas posteriores al �ltimo mensaje del usuario (usuarios activos) a trav�s del mismo n�mero de WhatsApp y eso tambi�n se denomina mensaje de sesi�n saliente. Los mensajes de sesi�n pueden ser texto libre, as� como mensajes audiovisual y no necesitan tener una plantilla definida para ser seguida por la empresa. A las empresas se les cobra un costo por mensaje de sesi�n para todos los mensajes entrantes y todos los mensajes de sesi�n salientes
El mensaje de plantilla es b�sicamente HSM (mensajes altamente estructurados o mensajes de plantilla) como los llama WhatsApp. La mensajer�a de plantilla se usa para enviar notificaciones transaccionales a los clientes optados. Si un cliente ha optado por el n�mero de WhatsApp registrado de una empresa por cualquiera de los 5 mecanismos proporcionados por Gupshup, se consideran usuarios habilitados. WhatsApp permite a las empresas hacer mensajes de plantilla con dichos usuarios. Los mensajes de plantilla solo deben seguir formatos de mensajes de texto aprobados previamente por WhatsApp (no se permiten mensajes multimedia). A las empresas se les cobra un costo por mensaje de plantilla para todos los mensajes de plantilla salientes seg�n su pa�s

Sus mensajes se entregan a un n�mero de destino seg�n las condiciones:

  • Si el n�mero de destino est� activo / inactivo
  • Si se env�a un mensaje de plantilla, si los plantillas de mensajes est�n activados / desactivados
  • Si se est� enviando una plantilla de mensaje y si el n�mero de destino est� inactivo, si el n�mero est� habilitado / no habilitado
  • Si la billetera tiene un equilibrio sustancial

SI LA PLANTILLA MENSAJER�A DE LA SE QUEDA

  • Y SI EL N�MERO DE DESTINO EST� ACTIVO - Independientemente de si intenta enviar un mensaje de texto libre o una plantilla de mensaje, se env�a como un mensaje de sesi�n, cobrando en consecuencia.
  • Y SI EL N�MERO DE DESTINO ES INACTIVO: el mensaje no se env�a en este caso.

LA PLANTILLA DE MENJAJE SE SIGUE ENCENDIDO -

  • Y SI EL N�MERO DE DESTINO ES OPTIN ACTIVO - Independientemente de si intenta enviar un mensaje de texto libre o una plantilla de mensaje, se env�a como un mensaje de sesi�n, con el cargo correspondiente.
  • Y SI EL N�MERO DE DESTINO ES OPTIN INACTIVO Y EL FORMATO DE MENSAJE COINCIDE CON UNA PLANTILLA APROBADA PREVIA- El mensaje se env�a como una plantilla de mensaje, que se cobra en consecuencia para el pa�s de destino respectivo.
  • Y SI EL N�MERO DE DESTINO ES UN OPTIN INACTIVO Y EL FORMATO DE MENSAJE NO COINCIDE CON LA PLANTILLA: el mensaje no se env�a en este caso.
  • Y SI EL N�MERO DE DESTINO NO EST� ABIERTO- El mensaje no se env�a en este caso.
Puedes decidir activarlo o desactivarlo desde la p�gina 'Configuraci�n'
Las empresas pueden usar cualquiera de las plantillas preaprobadas enumeradas por Gupshup en "Ver plantillas" en Configuraci�n. Para sugerencias de plantillas personalizadas, las empresas pueden completar el formulario aqu�
Gesti�n de usuarios

Hay dos tipos de estado de cada usuario que deben considerarse antes de que las empresas puedan enviarles mensajes-

  1. Basado en la actividad
  2. Basado en la aceptaci�n

ESTADO BASADO EN ACTIVIDAD -

Usuarios activos:

Usuarios que han enviado un mensaje a un n�mero de WhatsApp de la empresa dentro de las �ltimas 24 horas del per�odo de tiempo respectivo

Usuarios inactivos:

Usuarios que han enviado un mensaje a un n�mero de WhatsApp de la empresa fuera de la �ltima ventana de 24 horas del per�odo de tiempo respectivo o nunca han enviado un mensaje

ESTADO BASADO EN OPTIN

Optado en usuarios:

Usuarios que han optado espec�ficamente por recibir notificaciones de un negocio respectivo. Las empresas pueden obtener optins a trav�s de cualquiera de los mecanismos proporcionados por Gupshup.

Usuarios no habilitados:

Usuarios que nunca han habilitado o rechazado recibir notificaciones de un negocio respectivo.

Whatsapp exige que debe obtener un consentimiento voluntario de su usuario para enviarles notificaciones de plantilla.
Gupshup gestiona de manera eficiente sus usuarios elegidos por usted. Solo necesita que los usuarios utilicen cualquiera de los 5 mecanismos ofrecidos. (Consulte el paso 2 mientras prueba una aplicaci�n). Puede ver el estado de suscripci�n y actividad de los usuarios en el bot�n 'Ver usuarios' en la p�gina de Configuraci�n de la aplicaci�n respectiva.

Existen 5 mecanismos a trav�s de los cuales puede solicitar a los usuarios que comiencen a interactuar con usted. Puede encontrarlos en la p�gina 'Configuraci�n' de la aplicaci�n respectiva -

1. Escanee el c�digo QR

Cada aplicaci�n creada por usted en el panel de WhatsApp de Gupshup generar� un c�digo QR �nico. Sus usuarios pueden escanear este c�digo desde su material de marketing y aterrizar en el hilo de WhatsApp de su negocio.

2. Ir a URL

Cada aplicaci�n creada por usted en el panel de WhatsApp de Gupshup generar� una URL �nica de WhatsApp. Sus usuarios pueden hacer clic en esta URL desde su marketing en l�nea y aterrizar en el hilo de WhatsApp de su negocio.

3. Ir al widget web

Por cada aplicaci�n creada por usted en el panel de WhatsApp de Gupshup, obtendr� un c�digo de widget �nico que puede incrustar en sus p�ginas web. Sus usuarios pueden hacer clic en este widget y aterrizar en el hilo de WhatsApp de su negocio.

En los mecanismos n�mero 1, 2 y 3, Gupshup ha habilitado una verificaci�n de suscripci�n obligatoria antes de que lleguen a su hilo de WhatsApp.

C�mo se recopila optin una vez que el usuario utiliza los mecanismos anteriores:
Gupshup

4. Guarde el n�mero de tel�fono y chatee a trav�s de WhatsApp directamente

Sus usuarios tambi�n pueden guardar su n�mero de tel�fono de WhatsApp para aplicaciones en vivo promocionadas a trav�s de sus campa�as de marketing y chatear directamente con su empresa, al igual que cualquier chat P2P.

En el mecanismo n�mero 4, Gupshup env�a un mensaje de aceptaci�n al usuario, la primera vez que el usuario llega al hilo. Sin embargo, el usuario puede optar por optar o no m�s tarde o no optar en absoluto.

C�mo se recopila optin una vez que el usuario utiliza el mecanismo anterior:
Gupshup

5. Enviar SMS a los n�meros dados

Sus usuarios tambi�n pueden optar por SMS.

En el mecanismo n�mero 5, el SMS optin se considera como el optin del usuario, sin embargo, el usuario puede o no estar activo todav�a.

Configuraci�n y puesta en marcha

Para hacer que su aplicaci�n est� activa, al presionar 'Ir en vivo', aqu� est� el proceso que deber� seguir:

Checklist

Tendr� que asegurarse de que los siguientes elementos est�n en su lugar antes de presionar 'Ir en vivo' -

  1. Cuenta verificada del gerente de negocios de FB
  2. El n�mero de tel�fono debe cumplir con las pautas dadas aqu�
  3. El nombre para mostrar debe cumplir con las pautas dadas aqu�
Por lo general, la aprobaci�n de WhatsApp demora entre 2 y 7 d�as. Recibir� una notificaci�n por correo electr�nico cuando se reciban todas sus aprobaciones. Si su aplicaci�n no ha sido aprobada incluso despu�s de 15 d�as, escriba a devsupport@gupshup.io.

ID de FB Business Manager es una cadena num�rica de 15 o 16 d�gitos que se puede encontrar iniciando sesi�n en Facebook Business con las credenciales de administrador de su empresa.

  • Hit URL https://business.facebook.com
  • Inicie sesi�n en su cuenta comercial
  • Vaya a Configuraci�n empresarial (esquina superior derecha de la p�gina)
  • Haga clic en Informaci�n comercial (esquina inferior izquierda de la p�gina)
  • Debajo de la secci�n de informaci�n del administrador de negocios, ver� su ID de administrador de negocios (centro superior de la p�gina)

Si a�n no tiene una cuenta de Business Manager, puede crear una desde https://business.facebook.com > Crear cuenta

Su empresa debe usar un n�mero de tel�fono v�lido. Los c�digos cortos no est�n permitidos en la plataforma WhatsApp. El n�mero debe incluir un c�digo de pa�s y �rea. Los n�meros de tel�fono fijo y celular son n�meros de tel�fono aceptables para usar. Dado que un n�mero de tel�fono est� vinculado a una cuenta de WhatsApp, debe tener este n�mero. Este n�mero de tel�fono debe poder recibir llamadas de voz o SMS para completar el registro. Este n�mero de tel�fono tampoco debe haber sido utilizado antes con la API de WhatsApp Business. Lea la gu�a completa de WhatsApp
Cuando agrega un nuevo n�mero de tel�fono a su cuenta de WhatsApp en Facebook Business Manager, le asigna un nombre para mostrar. El nombre para mostrar se requiere para crear un certificado, sin el cual el cliente API de WhatsApp Business no funcionar�. Lea la gu�a completa de WhatsApp
Su nombre para mostrar se mostrar� de manera diferente a sus usuarios finales dependiendo de si su cuenta es una cuenta comercial o una cuenta comercial oficial.
Una vez que su aplicaci�n est� activa, vaya a Configuraci�n de perfil en el tablero para cambiar la imagen de visualizaci�n de su empresa.
S�, WhatsApp permitir� agregar el n�mero de tel�fono existente de la aplicaci�n empresarial / consumidor de WhatsApp a una WABA, pero no permitir� descargar el certificado para la configuraci�n del acoplador hasta que el n�mero de tel�fono y la cuenta asociada se eliminen de la aplicaci�n comercial / consumidor. Por lo tanto, no hemos proporcionado esta disposici�n en las herramientas y API de WhatsApp de Gupshup
Escriba al soporte de Gupshup en devsupport@gupshup.io con la l�nea de asunto en el formato "Problema de WhatsApp OTP: n�mero de tel�fono" junto con qu� tipo de n�mero de tel�fono es: m�vil, fijo, VoIP, etc.
Aunque depende totalmente de WhatsApp para rechazar o aceptar solicitudes de cuenta, consulte este enlace oficial que le da una idea de qu� tipo de verticales est�n restringidas por WhatsApp
Puede lanzarse en vivo con m�ltiples aplicaciones, funcionara sin problemas. Sin embargo, actualmente el filtrado basado en aplicaciones en an�lisis de uso y declaraci�n de billetera no estar� disponible. Proporcionaremos esta funcionalidad pronto

Puede recibir un mensaje de este tipo cuando el n�mero de tel�fono que est� intentando registrar ya est� activo en la aplicaci�n de WhatsApp para empresas / consumidores, Android / iOS.

Aseg�rese de cumplir con lo siguiente:

  1. El n�mero de tel�fono nunca debe usarse para WhatsApp Business API y no debe estar activo en la aplicaci�n WhatsApp Consumer / Business (Android / iOS) al registrarse con Gupshup
  2. Si el n�mero de tel�fono se us� en la aplicaci�n WhatsApp (Android / iOS), elimine la cuenta e intente nuevamente (por lo general, toma 7 d�as borrar el cach� y luego puede volver a intentarlo)
Accesso API
Access API es una API utilizada por las empresas para enviar notificaciones transaccionales, as� como enviar y recibir mensajes de clientes, integr�ndolo con su propio servicio o aplicaci�n. Por otro lado, la herramienta de soporte al cliente es una interfaz de usuario utilizada por las empresas para responder a las consultas de soporte al cliente a trav�s de WhatsApp con la ayuda de m�ltiples agentes de soporte.
No ofrecemos complementos listos, pero puede usar nuestra API para integrarse con otras plataformas CRM.
Se puede establecer una URL de devoluci�n de llamada a trav�s de la Configuraci�n de la aplicaci�n en la que Gupshup reenviar� todos los mensajes entrantes.
S�, puede enviar notificaciones (mensajes de plantilla) a sus usuarios habilitados.

Puede enviar los siguientes archivos adjuntos aparte del texto (caracteres en ingl�s y Unicode):

  • Enlace
  • Documento
    • texto / csv
    • texto / valores separados por comas
    • Texto sin formato
    • aplicaci�n / csv
    • application / vnd.ms-excel
    • Solicitud PDF
  • Imagen
    • imagen / png
    • imagen / jpeg
    • imagen / jpg
    • imagen / gif
  • Audio
    • audio / mpeg3
    • audio / x-mpeg-3
  • Video
    • video / mpeg
    • video / quicktime
    • video / mp4
    • video / mpeg
    • video / x-mpeg
Gupshup actualmente admite espaciado, l�nea siguiente, negrita, cursiva y emoticones
S�, tambi�n puede recibir y responder mensajes para n�meros internacionales
S�, puede cambiarlo, solo escriba a 'devsupport@gupshup.io' con los siguientes detalles: nombre de la aplicaci�n, clave API, n�mero de tel�fono m�vil registrado.
Actualmente esta caracter�stica no es compatible con nuestra plataforma
WhatsApp no admite el env�o de medios por secuencias de bytes

Use la API a continuaci�n para obtener la carga �til de los medios:

curl -X GET \ https://api.gupshup.io/sm/api/wamedia/{WhatsApp-App-name}/{VoiceID} \ -H 'apikey: {Gupshup-Account-APIkey}'

El tipo de respuesta ser�: application / octet-stream

Puede enviar hasta 20 mensajes / seg.
No, no se garantiza que el orden en que llegan los mensajes al usuario final est� en el mismo orden en que fueron enviados
Actualmente esta caracter�stica no es compatible con nuestra plataforma

No se crear� un �lbum si se cumple alguno de los siguientes requisitos:

  • Im�genes con subt�tulos
  • Divisor no le�do: el usuario ve algunas im�genes, pero no el resto
  • Mensaje del usuario u otros participantes si solo grupo
  • Encabezado de fecha - nuevo d�a entre entregas
Consulte aqu�, para obtener la documentaci�n de la API

En una actualizaci�n reciente, se modific� el mecanismo y la estructura de la respuesta API. Es decir, cada vez que realice una llamada API para enviar un mensaje a un usuario, ya que la respuesta API es as�ncrona, la respuesta inmediata ser� HTTP_SUCCESS y siempre obtendr� el cuerpo de respuesta que incluye un objeto con identificador de mensaje y estado.

Su devoluci�n de llamada establecida siempre recibir� el estado real del mensaje como un evento de mensaje.

Por lo tanto, recibir� una gran cantidad de mensajes de eventos. Consulte el siguiente enlace de documentaci�n de la API para su referencia https://www.gupshup.io/developer/docs/bot-platform/guide/whatsapp-api-documentation#APIResponse

Actualmente, no podr� enviar mensajes multimedia con subt�tulos, ya que no es compatible con nuestra plataforma. Sin embargo, lo tenemos en nuestra hoja de ruta y la funci�n deber�a estar disponible pronto
Herramienta de atenci�n al cliente
La herramienta de soporte al cliente es una interfaz de usuario utilizada por las empresas para responder a las consultas de soporte al cliente a trav�s de WhatsApp con la ayuda de m�ltiples agentes de soporte. Por otro lado, Accesso API es una API utilizada por las empresas para enviar notificaciones transaccionales, as� como para enviar y recibir mensajes de clientes, al integrarlo con su propio servicio o aplicaci�n.
Todos los mensajes entrantes ser�n visibles en el panel de atenci�n al cliente.
Actualmente, esta herramienta solo admite mensajes de sesi�n iniciados por el usuario final y no admite notificaciones push. Sin embargo, las notificaciones autom�ticas son una caracter�stica que planeamos ofrecer muy pronto y lo mantendremos informado. (Pr�ximamente)
  • Texto (caracteres ingleses y Unicode)
  • Enlace
  • Documento
    • texto / csv
    • texto / valores separados por comas
    • Texto sin formato
    • aplicaci�n / csv
    • application / vnd.ms-excel
    • Solicitud PDF
  • Imagen
    • imagen / png
    • imagen / jpeg
    • imagen / jpg
    • imagen / gif
  • Audio
    • audio / mpeg3
    • audio / x-mpeg-3
  • Video
    • video / mpeg
    • video / quicktime
    • video / mp4
    • video / mpeg
    • video / x-mpeg

Para los mensajes salientes, actualmente admitimos la siguiente l�nea (Shift + Enter); Espaciado, negrita, cursiva y emoticones actualmente no son compatibles. (Pr�ximamente)

Formatting Symbol Example
Bold Asterisk (*) Your total is *$10.50*.
Italics Underscore (_) Welcome to _WhatsApp_!
Strike-through Tilde (~) This is ~better~ best!
Emojis Grinning Face https://emojipedia.org/whatsapp/
Los agentes solo pueden enviar 10 mensajes a un solo usuario en 24 horas, o hasta que el usuario responda. Adem�s, hay un l�mite de 100000 mensajes que un agente puede enviar en total en 30 d�as.
No solo se puede agregar el nombre del cliente, sino tambi�n una peque�a nota que describe el estado del cliente.

Estos son los siguientes estados 'que puede ver en el panel:

  • Respondido: despu�s de que un agente responde a un chat
  • Sin respuesta: chat que ha recibido una notificaci�n BRB pero no est� atendido por un agente
  • Agente respondiendo: un agente est� respondiendo a un chat entrante
  • Agente de notificaci�n: chat entrante desatendido por un agente
Las etiquetas se utilizan para identificar una palabra clave o tema de inter�s y facilitar su b�squeda, como cliente premium, referencia, efectivo de entrega, etc. Esto puede ayudar a construir un perfil de su cliente.
S�, tambi�n puede recibir y responder mensajes para n�meros internacionales.
Actualmente no puede configurar n�meros que no sean indios para el Soporte al cliente de Whatsapp, sin embargo, este desarrollo de caracter�sticas est� en progreso. Estar� listo en los pr�ximos meses. (Pr�ximamente)
No, actualmente no puede asociar un bot al servicio de atenci�n al cliente, pero est� en nuestra hoja de ruta. Si tiene un requisito espec�fico en mente, puede escribirnos a devsupport@gupshup.io.

Google Chrome: versi�n 45 y superior

Mozilla Firefox: Versi�n 44 y superior

S�, esto se puede configurar en la Configuraci�n de la aplicaci�n. Configurar respuestas autom�ticas, mensaje de saludo, mensaje de ausencia, regreso enseguida (BRB).
Si es necesario revocar el acceso a los enlaces de chat en vivo de WhatsApp existentes (debido a problemas de rotaci�n o de seguridad personal), presione 'Actualizar acceso' en Configuraci�n para expirar TODOS los accesos existentes. Para continuar usando el chat en vivo de WhatsApp, use los nuevos enlaces generados en Configuraci�n de acceso directo a su herramienta de soporte al cliente de WhatsApp.
Se proporcionar� una URL en la que m�ltiples usuarios pueden iniciar sesi�n, no hay credenciales separadas para cada agente individual.
Actualmente, el panel de soporte al cliente de Gupshup no puede integrarse con otras plataformas CRM.
S�, puede cambiarlo, solo escriba a 'devsupport@gupshup.io' con los siguientes detalles: nombre de la aplicaci�n, clave API, n�mero de tel�fono m�vil registrado.
Para come�ar
A Gupshup, um parceiro de confian�a do WhatsApp, criou um portal de autoatendimento que permite, para uma empresa m�dia ou grande, ativar o WhatsApp Business em um n�mero espec�fico. Atrav�s deste n�mero, a empresa pode se comunicar com seus clientes e vice-versa.

A Gupshup fornece 2 tipos de ferramentas para mensagens no WhatsApp Business: o atendimento ao cliente e a API de acesso.

Veja quais s�o as diferen�as:

Atendimento ao cliente:

A ferramenta de atendimento ao cliente � uma ferramenta de interface de usu�rio usada por empresas para responder com facilidade e rapidez a quest�es feitas ao atendimento ao cliente. Ela funciona pelo WhatsApp e pode ser usada por v�rios agentes de atendimento.

Funcionalidades oferecidas pelo painel de atendimento ao cliente da Gupshup:

  • Resposta imediata a quest�es de clientes pela equipe de atendimento;
  • Compartilhamento com clientes de conte�do de m�dia interativa, como documentos, imagens, �udios e v�deos;
  • Respostas previamente definidas a quest�es frequentes podem ser criadas com resolu��o mais r�pida;
  • � poss�vel definir um nome e imagem de tela, bem como mensagens de recep��o customizadas de acordo com o perfil da empresa;
  • Alterna��o f�cil de mensagens automatizadas para bate-papo ao vivo;
  • Atendimento por PC dispon�vel, al�m do atendimento m�vel.

API de acesso:

A API de acesso � uma API usada por empresas para enviar notifica��es de transa��es ou para receber e enviar mensagens com clientes, integrando-as com o seu pr�prio servi�o ou aplicativo.

Funcionalidades oferecidas pela API de acesso da Gupshup:

  • API REST flex�vel que pode ser integrada com a sua plataforma de CRM ou de atendimento ao cliente, ou ainda com um aplicativo de chatbot existente;
  • Envio de mensagens a clientes atrav�s da API REST;
  • O atendimento pode enviar m�dia interativa como documentos, imagens, �udios e v�deos em resposta a consultas feitas por clientes e s� por 24 h desde a �ltima mensagem Enviada no WhatsApp pelo cliente;
  • O atendimento pode enviar modelos previamente aprovados de notifica��es para clientes que tenham optado por receb�-las;
  • Recebimento de mensagens enviadas por clientes via webhook;
  • Recebimento de m�dia interativa enviada por clientes, como documentos, imagens, �udios e v�deos;
  • Liberdade de projetar o aplicativo de acordo com o perfil do seu neg�cio.
A Gupshup oferece 2 tipos de mensagens para o WhatsApp: mensagens de sess�o (bidirecionais) e mensagens de modelo (HSM).
Sim, � poss�vel enviar notifica��es de texto (mensagens de modelo) atrav�s da nossa API de acesso. A mesma fun��o ser� providenciada em breve para a ferramenta de atendimento ao cliente.
Quando voc� vira usu�rio da Gupshup, creditamos $1 para a sua carteira do WhatsApp a fim de testar. Se voc� precisar de mais cr�ditos, voc� pode recarregar e adicionar o saldo � sua carteira do WhatsApp
Clique aqui para conferir os pre�os
N�o, n�o h� cobran�as adicionais.
Sandbox � o ambiente de demonstra��o (demo) que voc� pode usar para testar as funcionalidades da Gupshup e o comportamento de usu�rio final em comunica��es pelo WhatsApp Business. Voc� pode criar um app e test�-lo atrav�s da Sandbox caso tenha saldo em sua carteira. Clique aqui para criar um app e siga os passos dados. Nota: a Sandbox � limitada, de forma que usu�rios/desenvolvedores usando o atendimento ao cliente ou a API de acesso do WhatsApp s� poder�o enviar mensagens de texto.
A taxa do WhatsApp � uma taxa que varia de acordo com o pa�s do n�mero de destino. O WhatsApp s� cobra por mensagens de modelo, e n�o por mensagens de sess�o. A taxa da Gupshup, por outro lado, � uma taxa por mensagem que se aplica tanto a mensagens de modelo quanto de sess�o. Esta taxa inclui o custo de configura��o e manuten��o pelo servi�o fornecido.
S�o permitidos pelo WhatsApp casos de uso como notifica��es de transa��es, atendimento ao cliente, autentica��o multifator ou verifica��o de usu�rio. J� marketing ou mensagens promocionais ou de assinaturas s�o estritamente proibidas.
Mensagens de sess�o e de modelo

As empresas podem enviar 2 tipos de mensagens a seus usu�rios, dependendo de v�rias condi��es: mensagens de sess�o e mensagens de modelo.

As mensagens de sess�o s�o usadas para responder a perguntas ou mensagens de clientes. Se um cliente envia uma mensagem ao n�mero de WhatsApp registrado, esta mensagem se chama mensagem de sess�o recebida. O WhatsApp permite � empresa responder a este tipo de usu�rio dentro de 24 horas a partir da �ltima mensagem do usu�rio (usu�rio ativo) atrav�s do mesmo n�mero de WhatsApp - esta resposta � chamada de mensagem de sess�o enviada. As mensagens de sess�o podem ser texto livre ou conter m�dia, e n�o precisam ter um modelo predefinido a ser seguido pela empresa. � cobrado � empresa um custo por mensagem de sess�o para todas as mensagens de sess�o recebidas e enviadas.
As mensagens de modelo s�o basicamente HSMs (Mensagens Altamente Estruturadas, em sigla inglesa), como s�o chamadas pelo WhatsApp. As mensagens de modelo s�o usadas para enviar notifica��es de transa��o para clientes que deram consentimento. Se um cliente deu o consentimento para um n�mero de WhatsApp registrado � sua empresa atrav�s de qualquer um dos 5 mecanismos fornecidos pela Gupshup, considera-se que ele � um usu�rio facultativo. O WhatsApp permite que empresas enviem mensagens de modelo para este tipo de usu�rio. As mensagens de modelo devem seguir o formato de mensagens de texto aprovado pelo WhatsApp (n�o s�o permitidas mensagens com m�dia). � cobrado um custo por mensagem de modelo para todas as mensagens de modelo enviadas, de acordo com o pa�s.

As suas mensagens s�o enviadas para o n�mero de destino dependendo das condi��es abaixo:

  • Se o n�mero de destino est� ativo ou inativo;
  • Quando � uma mensagem de modelo que est� sendo enviada, se as mensagens de modelo est�o ativadas ou n�o;
  • Quando � uma mensagem de modelo que est� sendo enviada e o n�mero de destino est� inativo, se o n�mero � de usu�rio facultativo ou n�o;
  • Se a sua carteira possui saldo suficiente.

SE AS MENSAGENS DE MODELO ESTIVEREM DESATIVADAS -

  • E SE O N�MERO DE DESTINO ESTIVER ATIVO - independentemente de se voc� tenta mandar uma mensagem de texto livre ou de modelo, a mensagem � enviada como mensagem de sess�o, sendo cobrada como tal.
  • E SE O N�MERO DE DESTINO ESTIVER INATIVO - neste caso, a mensagem n�o � enviada.

SE AS MENSAGENS DE MODELO ESTIVEREM ATIVADAS -

  • E SE O N�MERO DE DESTINO FOR DE USU�RIO FACULTATIVO - independentemente de se voc� tenta enviar uma mensagem de texto livre ou de modelo, a mensagem � enviada como mensagem de sess�o, sendo cobrada como tal.
  • E SE O N�MERO DE DESTINO FOR DE USU�RIO FACULTATIVO INATIVO E O FORMATO DA MENSAGEM SE ENQUADRAR COM UM MODELO PREVIAMENTE APROVADO - a mensagem � enviada como mensagem de modelo, sendo cobrada de acordo com o pa�s de destino em quest�o.
  • E SE O N�MERO DE DESTINO FOR DE USU�RIO FACULTATIVO E O FORMATO DA MENSAGEM N�O SE ENQUADRAR COM UM MODELO - neste caso, a mensagem n�o � enviada.
  • E SE O N�MERO DE DESTINO N�O FOR DE USU�RIO FACULTATIVO - neste caso, a mensagem n�o � enviada.
Voc� pode decidir se quer ativar ou desativar esta op��o atrav�s da p�gina de configura��es.
A sua empresa pode usar qualquer um dos modelos previamente aprovados listados pela Gupshup na op��o "Ver modelos" da p�gina de configura��es. Para ver sugest�es de modelos personalizados, a empresa pode preencher o formul�rio aqui.
Gest�o de usu�rios

H� 2 tipos de status para cada usu�rio que devem ser considerados antes que a empresa lhes envie mensagens:

  1. baseados em atividade e
  2. baseados em consentimento.

STATUS BASEADO EM ATIVIDADE -

Usu�rios ativos:

S�o usu�rios que enviaram uma mensagem a um n�mero de WhatsApp Business dentro das �ltimas 24 horas contados a partir do envio da mensagem.

Usu�rios inativos:

S�o usu�rios que enviaram uma mensagem a um n�mero de WhatsApp Business fora das �ltimas 24 horas a partir do envio da mensagem, ou que nunca enviaram mensagens.

STATUS BASEADO EM CONSENTIMENTO

Usu�rios facultativos:

S�o usu�rios que expressamente optaram por receber notifica��es da empresa em quest�o. A empresa pode oferecer a possibilidade de op��o atrav�s de qualquer um dos mecanismos providenciados pela Gupshup.

Usu�rios n�o facultativos:

S�o usu�rios que n�o decidiram op��o ou que optaram por n�o receber notifica��es da empresa em quest�o.

O WhatsApp determina que deve ser obtido o consentimento volunt�rio do usu�rio antes de enviar notifica��es de modelo.
A Gupshup gerencia com efici�ncia os usu�rios facultativos para voc�. Voc� s� precisa obter estes usu�rios atrav�s de qualquer um dos 5 mecanismos oferecidos (ver passo 2 ao testar o app). Voc� pode ver o status de op��o e de atividade dos usu�rios atrav�s do bot�o "Ver usu�rios" na p�gina de configura��es do app em quest�o.

Existem 5 mecanismos pelos quais voc� pode pedir para o usu�rio se colocar em contato com voc�. Voc� pode acess�-los pela p�gina de configura��es do app em quest�o:

1. Fazer scan de um c�digo QR

Todo app criado por voc� no painel de WhatsApp da Gupshup gera um c�digo QR exclusivo. Os usu�rios podem escanear este c�digo a partir do material de marketing e assim chegar ao seu WhatsApp Business.

2. URL de acesso

Todo app criado por voc� no painel de WhatsApp da Gupshup gera um URL de WhatsApp exclusivo. Os usu�rios podem clicar neste URL a partir do seu marketing online e chegar ao seu WhatsApp Business.

3. Widget de acesso para web

Para todo app criado por voc� no painel de WhatsApp da Gupshup, um c�digo de widget exclusivo ser� gerado. Este c�digo poder� ser inclu�do na sua p�gina da web, onde os usu�rios poder�o clicar nele e chegar ao seu WhatsApp Business.

Nos mecanismos n�s 1, 2 e 3, a Gupshup ativou uma op��o obrigat�ria de consentimento pr�vio antes que o usu�rio seja enviado ao seu WhatsApp.

Como o consentimento � coletado ap�s o usu�rio usar os mecanismos acima:
Gupshup

4. Salvar n�mero de telefone e falar diretamente pelo WhatsApp

Os usu�rios tamb�m podem salvar o seu n�mero de WhatsApp em apps ativos promovidos atrav�s das suas campanhas de marketing e entrar em contato com a sua empresa diretamente, como qualquer outro bate-papo P2P.

No mecanismo n� 4, a Gupshup mostra uma mensagem de consentimento ao usu�rio j� da primeira vez que ele chega ao seu WhatsApp. Contudo, o usu�rio pode decidir dar ou n�o dar o consentimento mais tarde.

Como o consentimento � coletado ap�s o usu�rio usar o mecanismo acima:
Gupshup

5. Enviar SMS para determinados n�meros

Os usu�rios tamb�m podem dar o consentimento atrav�s de SMS.

No mecanismo n� 5, o SMS de consentimento � considerado como consentimento do usu�rio. Contudo, o usu�rio pode ou n�o estar ativo neste momento.

Configura��es e enviar ao vivo

Para deixar o app ao vivo (ativo), h� um processo a ser seguido ap�s apertar o bot�o "Lan�ar ao vivo" -

Checklist

Voc� precisa garantir que os itens a seguir tenham sido cumpridos antes de apertar o bot�o "Lan�ar ao vivo"

  1. Conta de gerenciador verificada no Facebook para Empresas.
  2. O n�mero de telefone deve aderir �s diretrizes enumeradas aqui.
  3. O nome de exibi��o deve aderir �s diretrizes enumeradas aqui.
Geralmente, leva de 2 a 7 dias para a aprova��o pelo WhatsApp. Voc� receber� uma notifica��o por e-mail quando todas as aprova��es forem recebidas. Se o app n�o tiver sido aprovado mesmo ap�s 15 dias, entre em contato atrav�s de devsupport@gupshup.io.

O ID de gerenciador do Facebook para Empresas � uma sequ�ncia num�rica de 15 ou 16 d�gitos que voc� acessa ao fazer login no Facebook para Empresas com as credenciais da sua companhia.

  • Acesse o URL https://business.facebook.com
  • Fa�a login � sua conta no Facebook para Empresas
  • V� para Configura��es de empresa (no canto superior direito da p�gina)
  • Clique em Informa��es de empresa (canto inferior esquerdo da p�gina)
  • Embaixo da se��o Informa��es de gerenciador de empresa, voc� ver� o ID de gerenciador de empresa (no alto e centro da p�gina).

Caso voc� ainda n�o tenha uma conta de gerenciador de empresa, voc� pode cri�-la a partir do link https://business.facebook.com > Criar conta

A sua empresa deve usar um n�mero de telefone v�lido. C�digos curtos n�o s�o permitidos na plataforma do WhatsApp. O n�mero deve incluir c�digo de pa�s e de �rea. N�meros de telefones fixos e de celulares s�o aceit�veis e podem ser usados. Dado que o n�mero do telefone � ligado � conta WhatsApp, ele deve pertencer a voc�. O n�mero de telefone deve poder receber chamadas de voz ou mensagens SMS a fim de ser poss�vel completar o processo de registro. O n�mero tamb�m n�o pode ter sido usado com a API WhatsApp Business antes. Leia o guia completo do WhatsApp.
Quando voc� adiciona um novo n�mero de telefone � sua conta WhatsApp no Gerenciador de empresa do Facebook, � necess�rio conferir um nome de exibi��o. Ele � exigido a fim de criar um certificado, sem o qual o cliente da API WhatsApp Business n�o funciona. Leia o guia completo do WhatsApp.
O seu nome de exibi��o aparecer� de formas diferentes para os usu�rios finais - isto depende de se a sua conta � uma conta de empresa ou conta de empresa oficial. Leia mais aqui.
Ap�s o seu app ter sido lan�ado ao vivo, v� para Configura��es de perfil no painel a fim de mudar a imagem de exibi��o da empresa.
Sim, o WhatsApp permitir� que um n�mero existente de WhatsApp Business ou de consumidor a uma conta de empresa do WhatsApp, mas n�o permite baixar o certificado para instala��o de docker at� que o n�mero de telefone e a conta associada tenham sido removido do app do WhatsApp Business ou de consumidor. Por isso, n�o oferecemos esta possibilidade nas ferramentas e APIs para WhatsApp da Gupshup.
Contate o atendimento da Gupshup pelo e-mail devsupport@gupshup.io o assunto no formato "Problema com senha �nica do WhatsApp OTP: N�mero de telefone" juntamente com o tipo do n�mero telef�nico (m�vel, fixo, VoIP, etc.)
� o WhatsApp que decide se rejeita ou aceita um pedido de conta, mas voc� pode verificar esta p�gina oficial a qual lhe d� uma ideia dos tipos de nichos restritos pelo WhatsApp
Voc� pode ir ao ar com v�rios apps, os quais funcionar�o sem problemas. Contudo, a filtragem de aplicativos para os dados de uso e o extrato da carteira n�o estar�o dispon�veis no momento. Esta funcionalidade ser� disponibilizada em breve.

Voc� pode receber uma mensagem assim quando o n�mero de telefone que voc� est� tentando cadastrar j� se encontra ativo no aplicativo do WhatsApp Consumer/Business (para Android/iOS).

Certifique-se de estar cumprindo com as seguintes condi��es:

  1. O n�mero de telefone n�o pode ter sido usado nunca com a API do WhatsApp Business e n�o pode estar ativo no aplicativo do WhatsApp Consumer/Business (Android/iOS) durante o momento do cadastro via Gupshup.
  2. Se o n�mero de telefone j� havia sido usado no aplicativo do WhatsApp (Android/iOS), delete a conta e tente novamente (geralmente leva 7 dias para o cache ser esvaziado, ap�s o que voc� pode tentar).
API de acesso
A API de acesso � uma API usada por empresas para enviar notifica��es de transa��es ou para receber e enviar mensagens com clientes, integrando-as com o seu pr�prio servi�o ou aplicativo. Por outro lado, a ferramenta de atendimento ao cliente � uma ferramenta de interface de usu�rio usada por empresas para responder com facilidade e rapidez a quest�es feitas ao atendimento ao cliente. Ela funciona pelo WhatsApp e pode ser usada por v�rios agentes de atendimento.
N�o oferecemos plugins prontos, mas voc� pode usar a nossa API para integrar com outras plataformas CRM.
� poss�vel configurar um URL de chamada de retorno atrav�s das configura��es do aplicativo. Atrav�s dela, a Gupshup encaminhar� todas as mensagens recebidas.
Sim, voc� pode enviar notifica��es (mensagens de modelo) para os usu�rios facultativos.

Voc� pode enviar os seguintes anexos, al�m de texto (caracteres do ingl�s e Unicode):

  • Link
  • Documento
    • text/csv
    • texto/valores-separados-por-v�rgula
    • texto/simples
    • aplicativo/csv
    • aplicativo/vnd.ms-excel
    • aplicativo/pdf
  • Imagem
    • imagem/png
    • imagem/jpeg
    • imagem/jpg
    • imagem/gif
  • �udio
    • �udio/mpeg3
    • �udio/x-mpeg-3
  • Video
    • video/mpeg
    • video/quicktime
    • video/mp4
    • video/mpeg
    • video/x-mpeg
Atualmente, a Gupshup suporta espa�amento, pr�xima linha, negrito, it�lico e emojis.
Sim, voc� tamb�m pode receber e responder a mensagens para n�meros internacionais.
Sim, � poss�vel alternar - basta contatar 'devsupport@gupshup.io' os seguintes detalhes: nome do apps, chave da API, n�mero m�vel registrado.
No momento esta fun��o n�o est� dispon�vel na nossa plataforma.
O WhatsApp n�o suporta o envio de m�dia por fluxo de bytes.

Use a API abaixo para obter a payload de m�dia:

curl -X GET \ https://api.gupshup.io/sm/api/wamedia/{WhatsApp-App-name}/{VoiceID} \ -H 'apikey: {Gupshup-Account-APIkey}'

O tipo de resposta ser�: application/octet-stream

Voc� pode enviar at� 20 mensagens por segundo.
N�o, n�o se garante que a ordem pela qual as mensagens chegam ao usu�rio ser� a mesma com a qual as mensagens foram enviadas.
No momento esta fun��o n�o est� dispon�vel na nossa plataforma.

O �lbum n�o ser� criado se alguma das condi��es seguintes estiver presente:

  • Imagens com subt�tulos
  • Divisor de mensagens n�o lidas: o usu�rio visualiza algumas das imagens, mas n�o o resto
  • Mensagem do usu�rio ou de outros participantes se for s� para grupo
  • Cabe�alho de data: um novo dia separa as mensagens
Confira aqui para obter a documenta��o da API.

Em uma atualiza��o recente, o mecanismo e a estrutura da resposta da API foram alterados. Isso quer dizer que sempre que voc� fizer uma chamada pela API a fim de enviar uma mensagem para um usu�rio, dado que a resposta da API � ass�ncrona, a resposta imediata ser� HTTP_SUCCESS e voc� sempre receber� o corpo da mensagem de resposta, a qual incluir� um assunto com identificador de mensagem e status.

A sua chamada de retorno definida sempre receber� o status da mensagem como uma mensagem de evento.

Por isso, voc� receber� uma s�rie de mensagens de evento. Confira o link abaixo de documenta��o da API para mais informa��es: https://www.gupshup.io/developer/docs/bot-platform/guide/whatsapp-api-documentation#APIResponse

No momento, voc� n�o poder� enviar mensagens de m�dia com legendas, dado que ainda n�o s�o sustentadas pela nossa plataforma. Contudo, esta funcionalidade est� em nossos planos e dever� ser disponibilizada em breve.
Ferramenta de atendiento ao cliente
A ferramenta de atendimento ao cliente � uma ferramenta de interface de usu�rio usada por empresas para responder com facilidade e rapidez a quest�es feitas ao atendimento ao cliente. Ela funciona pelo WhatsApp e pode ser usada por v�rios agentes de atendimento. Por outro lado, a API de acesso � uma API usada por empresas para enviar notifica��es de transa��es ou para receber e enviar mensagens com clientes, integrando-as com o seu pr�prio servi�o ou aplicativo.
Todas as mensagens recebidas ficar�o vis�veis no painel de atendimento ao cliente.
No momento esta ferramenta s� suporta mensagens de sess�o iniciadas pelo usu�rio final e n�o suporta notifica��es push. No entanto, pretendemos oferecer notifica��es push em breve e o manteremos atualizado em rela��o a isso (em breve).
  • Voc� pode enviar os seguintes anexos, al�m de texto (caracteres do ingl�s e Unicode):
  • Link
  • Documento
    • text/csv
    • texto/valores-separados-por-v�rgula
    • text/plain
    • aplicativo/csv
    • application/vnd.ms-excel
    • application/pdf
  • Imagem
    • Imagem/png
    • Imagem/jpeg
    • Imagem/jpg
    • Imagem/gif
  • �udio
    • �udio/mpeg3
    • �udio/x-mpeg-3
  • Video
    • video/mpeg
    • video/quicktime
    • video/mp4
    • video/mpeg
    • video/x-mpeg

Para mensagens enviadas, atualmente suportamos pr�xima linha (Shift+Enter); j� o espa�amento, negrito, it�lico n�o s�o suportados no momento (em breve).

Formatting Symbol Example
Bold Asterisk (*) Your total is *$10.50*.
Italics Underscore (_) Welcome to _WhatsApp_!
Strike-through Tilde (~) This is ~better~ best!
Emojis Grinning Face https://emojipedia.org/whatsapp/
Agentes podem enviar somente 10 mensagens para um �nico usu�rio dentro de 24 horas ou at� que o usu�rio responda. Al�m disso, h� um limite de 100000 mensagens que um agente pode enviar em um total de 30 dias.
Sim. Voc� pode adicionar, n�o s� o nome do cliente, mas tamb�m uma pequena nota descrevendo o status dele.

Aqui est�o os status que voc� pode encontrar no painel:

  • Respondido: depois que um agente responde a uma conversa
  • N�o respondido: conversa que recebeu uma notifica��o de "volto logo" mas n�o foi atendida por um agente
  • Agente respondendo: um agente est� respondendo � conversa recebida
  • Notificando agente: conversa recebida que n�o foi atendida por um agente
As etiquetas servem para identificar uma palavra-chave ou t�pico de interesse e facilitar uma busca pelo mesmo. Exemplos: cliente premium, refer�ncia, dinheiro de frete, etc. Isto pode ajudar a montar um perfil para o cliente.
No momento n�o � poss�vel definir n�meros n�o indianos para o atendimento ao cliente por WhatsApp, mas esta fun��o est� sendo desenvolvida e estar� pronta nos pr�ximos meses (em breve).
No momento n�o � poss�vel definir n�meros n�o indianos para o atendimento ao cliente por WhatsApp, mas esta fun��o est� sendo desenvolvida e estar� pronta nos pr�ximos meses (em breve).
N�o, atualmente n�o � poss�vel associar um bot ao atendimento ao cliente, mas isto est� nos nossos planos. Caso voc� tenha um requerimento espec�fico em mente, contate-nos atrav�s de devsupport@gupshup.io.

Google Chrome: vers�es 45 e superiores

Mozilla Firefox: vers�es 44 e superiores

Sim, isto pode ser configurado atrav�s das configura��es do app, criar respostas automatizadas, mensagem de ol�, mensagem ausente, volto logo.
Se for necess�rio revogar acesso a algum link de conversa ao vivo no WhatsApp (devido ao volume de pessoas ou quest�es de seguran�a), aperte "Refrescar acesso" em Configura��es para fazer expirar TODO o acesso existente. Para continuar a usar uma conversa ao vivo no WhatsApp depois disto, use os novos links gerados em Atalho de configura��es para a sua ferramenta de atendimento ao cliente pelo WhatsApp.
Ser� fornecido um URL pelo qual diferentes agentes poder�o fazer login, mas n�o h� credenciais diferentes para cada agente.
Atualmente o painel de atendimento ao cliente da Gupshup n�o integra com outras plataformas CRM.
Sim, � poss�vel alternar - basta contatar 'devsupport@gupshup.io' com os seguintes detalhes: nome do apps, chave da API, n�mero m�vel registrado.

Please wait

Added below language support for WhatsApp,

Bot developers for Line: With the release of Line Messaging API, all BOT API Trial Accounts are scheduled to be deleted. Please republish your bot according to new Line implementation, mentioned under Publish tab in My Bots section.

New tool for non-developers- Our Flow Bot Builder helps users create their bot messaging flow with a graphical editor.

API.ai tool is now available for developing your NLP/AI bot.

Gupshup Enterprise APIs (SMS,Voice and Email) are now available directly in the APIs section.

New channels added for publishing bots- Smooch.io and your website as a web widget.

Now you can access our services including the bot builder tool using your Facebook login credentials.

Now you can delete the dummy bots created for testing from the My Bots Dashboard.

You can now access Bot specific data from your Dashboard itself.

Introducing a hassle free bot development experience for users to instantly create bots using our pre-defined restaurant templates. Check out our blog to know more.

We are removing few redundant parameters, that were being sent when a callback happens to your bot (i.e. inbound message comes to your bot).

Following is the list of parameters.

  1. sender
  2. message
  3. context

However, we will continue to send following parameters. If you are using any of the deprecated parameters, we request you to use these alternatives.

  1. senderobj
  2. messageobj
  3. contextobj

You are requested to make a note of this and do the necessary changes immediately to your bot code to keep it working. Should you need any help, please feel free to send an email to devsupport@gupshup.io