Saipos

A Saipos é um sistema de gestão para restaurantes, bares e operações de delivery, com recursos de pedidos, ponto de venda, estoque, financeiro e emissão fiscal.

A integração com o Falaê consulta os dados de vendas da loja na Saipos para cadastrar clientes, registrar e atualizar seus consumos e enviar a pesquisa de satisfação pelos canais configurados no Falaê. Para conectar a loja, você precisa de um token da API de Dados da Saipos e de uma pesquisa cadastrada no Falaê.

Antes de começar

• Tenha acesso à tela de Integrações no Falaê com um perfil autorizado a configurar a integração. O perfil Caixa não pode realizar essa configuração.
• Tenha uma pesquisa cadastrada na empresa ou unidade que será integrada.
• Solicite à Saipos um token da API de Dados com acesso somente à loja que deseja conectar.
• Para enviar as pesquisas, mantenha configurado e habilitado no Falaê pelo menos um canal de envio: e-mail, WhatsApp ou SMS.

O acesso à API de Dados possui cobrança adicional pela Saipos. Confira as condições de contratação e quem será responsável pelo pagamento na documentação oficial da API de Dados.

Como configurar a integração

1. Solicite o token à Saipos

1. Abra o formulário de solicitação de token da API de Dados, indicado na documentação oficial da Saipos.
2. Preencha a solicitação para a loja que será integrada ao Falaê e peça acesso exclusivo aos dados dessa loja.
3. Aguarde a liberação do token pela Saipos. A documentação informa retorno em até um dia útil, por e-mail.
4. Tenha o token recebido em mãos para preencher a configuração no Falaê.

O campo Token do Falaê recebe a chave fornecida pela Saipos para consultar a API de Dados. Se você já possui uma chave para outra integração, confirme com a Saipos se ela corresponde a esse acesso e à loja correta.

2. Configure a Saipos no Falaê

1. Acesse a tela de Integrações no Falaê.
2. No campo Pesquisar integração, procure por Saipos e abra o card da integração, na categoria PDV.
3. Se você gerencia uma rede, localize a unidade desejada na lista e abra sua configuração.
4. No campo Token, cole o token da API de Dados recebido da Saipos para aquela loja.
5. No campo Pesquisa, selecione a pesquisa de satisfação que deseja vincular. A lista mostra apenas as pesquisas da empresa ou unidade selecionada.
6. Clique em Configurar integração e aguarde a confirmação.
7. Confira se a tela exibe Integração configurada.

O botão Configurar integração fica desabilitado enquanto o token ou a pesquisa não estiverem preenchidos. Se a empresa não tiver nenhuma pesquisa cadastrada, crie uma pesquisa e reabra a configuração.

3. Confira a importação e o envio

1. Acompanhe uma venda recente, não cancelada, registrada na Saipos com nome e telefone válido do cliente. Para conferir o envio por e-mail, o cliente também precisa ter um e-mail informado na venda.
2. Aguarde a consulta automática dos dados pelo Falaê.
3. Confira no Falaê se o cliente foi cadastrado ou localizado e se o consumo foi registrado com o valor da venda.
4. Confira o recebimento da pesquisa pelo canal habilitado para a empresa ou unidade.

A confirmação da configuração indica que o token e a pesquisa foram cadastrados no Falaê. A conferência da importação e do envio confirma o funcionamento do fluxo com os dados da loja.

Como funciona a integração

1. As vendas e os dados dos clientes são registrados no sistema Saipos.
2. Com a integração habilitada, o Falaê consulta periodicamente a API de Dados da Saipos, utilizando o token informado. Cada consulta busca vendas cuja última atualização na Saipos ocorreu entre 72 e 4 horas antes da consulta.
3. O Falaê verifica se a venda já possui um consumo na empresa ou unidade configurada. Se já existir, atualiza o valor, a data e a validade do mesmo consumo, conforme os dados da Saipos, sem duplicar o registro nem reenviar a pesquisa. Essa atualização acontece mesmo quando a venda retorna sem telefone do cliente.
4. Para uma venda ainda não importada, não cancelada e com telefone do cliente, o Falaê cadastra ou localiza o cliente usando os dados disponíveis, como nome, telefone e e-mail. Em seguida, registra o consumo, com o valor total e a data da venda, vinculado ao cliente e à empresa ou unidade configurada.
5. Ao registrar esse novo consumo, conforme as opções de envio habilitadas, o Falaê encaminha a pesquisa por e-mail, WhatsApp ou SMS. O envio por e-mail depende também de o cliente possuir esse contato.
6. O cliente acessa a pesquisa recebida e responde sobre sua experiência.

Se uma venda for cancelada na Saipos, o consumo já registrado no Falaê é marcado como inválido, preservando o histórico. Uma venda que já estiver cancelada antes da primeira importação não gera consumo nem envio de pesquisa.

A janela de consulta permite recuperar alterações e vendas disponibilizadas com atraso. Em períodos de maior processamento, a Saipos informa que os dados podem ficar disponíveis apenas no dia seguinte (D+1), atraso contemplado pela janela de 72 horas. A importação depende de os dados estarem disponíveis na API e dentro do período consultado. Consulte as orientações da Saipos sobre atualização dos dados.

Vendas atualizadas há menos de 4 horas ainda não entram na consulta. Aguarde as consultas seguintes para conferir a importação ou a atualização do consumo.

Dúvidas e manutenção

Nenhuma pesquisa aparece para selecionar. O que fazer?

Crie uma pesquisa na empresa ou unidade que você está configurando e reabra a integração. Pesquisas de outras unidades não aparecem nessa seleção.

Posso conectar mais de uma unidade?

Sim. Configure cada unidade separadamente no Falaê, usando um token exclusivo da loja correspondente e uma pesquisa daquela unidade.

A Saipos também disponibiliza tokens com acesso a várias lojas, mas, para este fluxo de configuração, utilize um token por loja. A API de Dados não oferece filtro por loja; um token de rede pode retornar vendas de várias unidades na mesma consulta. Confira as orientações oficiais sobre tokens e lojas.

O cliente precisa ter telefone na Saipos?

Para importar uma venda pela primeira vez e cadastrar ou localizar o cliente, sim, inclusive quando o canal escolhido para enviar a pesquisa é o e-mail. Mantenha o cadastro do cliente preenchido na Saipos com os contatos que deseja utilizar.

Para atualizar ou invalidar um consumo já registrado, o telefone não é necessário. O Falaê reconhece a venda pelo seu número na mesma empresa ou unidade e atualiza o registro sem reenviar a pesquisa.

O consumo aparece, mas a pesquisa não chega. O que conferir?

Confira se o canal desejado está configurado e habilitado no Falaê para aquela empresa ou unidade. Verifique também se o telefone está correto e, para envio por e-mail, se esse contato foi informado na Saipos. A configuração da integração não habilita os canais de envio automaticamente.

Se o problema continuar, solicite ajuda ao suporte do Falaê, informando a unidade, o número da venda e a data em que ela foi registrada.

Configurei a integração, mas nenhuma venda aparece. O que conferir?

Confirme se o token é da API de Dados, se está liberado e se corresponde à loja configurada. Para a primeira importação, verifique se existem vendas não canceladas com telefone do cliente. Considere o possível atraso de disponibilização dos dados pela Saipos e aguarde uma consulta em que a última atualização da venda já tenha pelo menos 4 horas e esteja dentro da janela de 72 horas.

Se o token tiver sido cancelado ou a loja estiver cancelada na Saipos, a consulta pode deixar de fornecer os dados esperados. Para conferir o acesso ou solicitar uma nova chave, procure o suporte da Saipos para parceiros. Para investigar a importação no Falaê, informe ao suporte a unidade e o período das vendas que não apareceram.

A configuração importa todo o histórico de vendas?

A configuração habilita as consultas automáticas pela data da última atualização da venda na Saipos, dentro da janela de 72 a 4 horas anteriores a cada consulta. Uma venda criada há mais tempo pode entrar no fluxo se tiver sido atualizada nesse período. A configuração não representa uma solicitação de importação de todo o histórico da loja. Se precisar recuperar um período anterior, consulte o suporte do Falaê sobre a possibilidade de importação.

Como trocar o token ou a pesquisa vinculada?

Abra a configuração da unidade, clique em Cancelar integração e configure novamente com o token e a pesquisa desejados. Para substituir uma chave cancelada, aguarde a Saipos liberar o novo token antes de fazer a nova configuração.

Como desconectar a integração?

1. Acesse Integrações no Falaê e abra Saipos.
2. Se você gerencia uma rede, abra a configuração da unidade que deseja desconectar.
3. Clique em Cancelar integração e aguarde a mensagem Integração desligada com sucesso.

O cancelamento desativa a integração da unidade no Falaê e remove as credenciais e o vínculo com a pesquisa usados nesse fluxo.

Para revogar a chave de acesso ou encerrar a contratação da API de Dados na Saipos, solicite o cancelamento diretamente à Saipos pelo formulário de cancelamento de token. Desconectar no Falaê não cancela o token nem a cobrança da Saipos.

Se o botão de cancelamento estiver desabilitado por falta de permissão, solicite a um administrador a permissão de visualizar integrações. O perfil Caixa não pode cancelar integrações.