Zid Assistant
Visão geral
O Zid Assistant é a mesa de WhatsApp, Instagram e chat do site de uma loja Zid. Produtos, pedidos, carrinhos abandonados e clientes chegam do Zid sozinhos, e o assistente responde aos clientes a qualquer hora no idioma deles, com os modelos de IA do próprio MonoChat: não há nenhuma chave de IA para informar.
Perguntas sobre envio, devoluções e as suas próprias perguntas são respondidas apenas com as políticas e perguntas que você aprova. Sempre que uma pessoa é necessária, o assistente passa a conversa para a sua equipe ou anota um recado.
Destaques
- Produtos no chat. Os clientes pedem um produto, um tamanho ou uma cor e recebem cards de produto com foto, preço e os botões Buy (Comprar) e Details (Detalhes). Buy abre a página do produto na sua loja Zid.
- "Onde está meu pedido?" respondido. O assistente encontra o pedido pelo número ou pelo telefone do cliente e informa o status, a transportadora e o link de rastreio que o Zid tem.
- Atualizações de pedido. O cliente é avisado uma vez por mudança: quando o pedido é enviado, entregue ou cancelado.
- Confirmação de pagamento na entrega. Um pedido novo pago na entrega recebe no WhatsApp os botões Confirm order (Confirmar pedido) e Cancel order (Cancelar pedido). Sua equipe vê a resposta e altera o pedido no Zid; se ninguém responder, sua equipe recebe um retorno de ligação. Pedidos já confirmados no Zid não são perguntados de novo.
- Carrinhos abandonados. Carrinhos deixados no checkout do Zid recebem até três lembretes com o link de volta ao carrinho.
- Avisos de volta ao estoque, devoluções e campanhas funcionam como no Shop Assistant.
Conectar o Zid
O Zid abre uma loja para um app por meio de um app privado que a loja aprova. Os tokens dele vêm do Zid Bridge, a ferramenta do próprio Zid para apps privados, então você não precisa de um servidor próprio.
- No Zid Partner Dashboard (
partners.zid.sa), abra Apps › All Apps › Create Application e crie um app privado para a sua loja chamado MonoChat. Dê a ele acesso de leitura a pedidos, produtos, clientes, carrinhos abandonados e dados da loja. - Cadastre-se no Zid Bridge (
bridge.zid.dev), registre o app com o client ID e o client secret dele (em API keys, nas General settings do app) e coloque nas configurações do app as URLs de redirect e callback que o Zid Bridge fornece. - Ative o app na sua loja e aprove as permissões. Se o Zid pedir o complemento Direct Integration (APIs), a loja o assina antes. Depois o Zid Bridge mostra os tokens uma única vez: copie o Raw JSON.
- No MonoChat, abra o Shop desk, vá até Shop connection (Conexão da loja) e escolha Zid em Your web shop runs on (Sua loja on-line usa).
- Preencha Client ID, Client secret e Redirect URL (URL de redirecionamento, a que o Zid Bridge deu) e cole o Raw JSON em Tokens from Zid Bridge (Tokens do Zid Bridge).
- Clique em Test connection (Testar conexão) e depois em Sync now (Sincronizar agora).
O client secret e os tokens ficam no servidor e aparecem mascarados. O Zid pede que os apps renovem os tokens em um calendário, então o app os renova sozinho a cada 10 meses; é para isso que servem o client secret e a URL de redirecionamento. Se o Zid deixar de aceitar os tokens (o app foi desativado ou as permissões mudaram), a tela de conexão e a sincronização mostram um erro de reconexão: ative o app de novo pelo Zid Bridge e cole os novos tokens. O Zid Bridge guarda o client ID e o client secret do seu app, não os tokens.
O que vem do Zid
| Dados | Com que frequência | O que o app guarda |
|---|---|---|
| Pedidos | A cada 10 minutos (ajustável em Sync every (minutes)) | Número, status, itens, total, forma de pagamento, transportadora, código e link de rastreio |
| Carrinhos abandonados | A cada 10 minutos | Cliente, telefone, itens, total e o link de volta ao carrinho |
| Produtos | A cada hora e a cada Sync now | Nome, descrição, categoria, marca, fotos, link, variantes com preço, preço promocional e estoque |
| Clientes | Uma vez por dia | Nome, telefone e e-mail |
A primeira sincronização lê os pedidos dos últimos 30 dias e os carrinhos abandonados que os lembretes ainda alcançam (7 dias por padrão). A moeda da loja é preenchida a partir do primeiro pedido quando está vazia. A sincronização fica dentro do limite do Zid de 60 requisições por minuto.
- O app apenas lê do Zid; não escreve nada de volta. Um cancelamento ou uma mudança de status é feito pela sua equipe no Zid.
- As mudanças no Zid chegam ao MonoChat na próxima sincronização, não na hora: o app ainda não recebe os webhooks do Zid.
- O proprietário, ou um usuário com uma função personalizada chamada manager, altera as configurações, testa a conexão com a Zid e carrega ou remove os dados de exemplo. Cada agente trabalha no painel e pode iniciar uma sincronização.