Abaixo você poderá conhecer as respostas às principais dúvidas frequentes sobre a implementação da API de Mensageria, além das melhores práticas a serem aplicadas.
|
API de Mensageria | |
| FAQ |
Dados-chave |
|
O bot responde como se fosse a primeira vez, mas estou no meio de um fluxo. |
A sessão provavelmente expirou. Reinicie o fluxo com o sentence inicial. Use sempre o mesmo user.hash. |
|
Recebo um HTTP 401 em todas as chamadas. |
O Bearer Token expirou. Obtenha um novo token com POST /auth e tente novamente. Recomenda-se armazenar em cache e renovar proativamente. |
|
O campo text vem vazio, mas há complementos. |
Isso é normal em alguns casos, como na lista interativa. Renderize os complementos como conteúdo principal. |
|
O que eu faço com o value de botões do tipo step? |
Nunca o envie como sentence. Em botões do tipo step, sempre se envia o LABEL. |
|
Posso enviar várias mensagens em paralelo para o mesmo usuário? |
Não. A API é stateful. O envio deve ser sempre sequencial. |
|
O que acontece se o usuário fechar o aplicativo no meio de um fluxo? |
A sessão permanece ativa até expirar. Se ele voltar antes com o mesmo hash, continua de onde estava. Se a sessão expirou, ele deve reiniciar. |
|
Como testo a integração sem afetar a produção? |
Solicite à sua equipe técnica as credenciais de um ambiente de QA/teste. |
Boas práticas:
- Use um hash e um ID diferentes para cada nova sessão de um usuário. Não reutilize hashes entre usuários.
- Sempre encerre a sessão (por inatividade ou porque o cliente a fechou).
- Não gere um Bearer Token novo a cada consulta. Ele dura 10 horas e pode ser reutilizado.
- Armazene o Bearer Token em cache e renove-o proativamente antes que expire.
- Não envie mensagens em rajada sem throttle. Implemente debounce no frontend para cliques rápidos.
- Use sempre o mesmo hash/id durante toda a conversa.
- Implemente um timeout do lado do cliente em caso de inatividade.
- Tolere complementos desconhecidos: ignore-os sem quebrar a integração.