A API do Flagy deixa o seu sistema conversar com o atendimento: listar e abrir conversas, ler e enviar mensagens, mudar a situação de uma conversa, consultar e cadastrar contatos e listar canais e fluxos. A documentação segue o padrão OpenAPI.
Cada chave de acesso é criada no painel com só as permissões necessárias, como apenas ler conversas ou apenas cadastrar contatos, e pode ser revogada a qualquer momento.
Os webhooks fazem o caminho inverso: o Flagy avisa o seu sistema quando uma conversa é criada, transferida ou resolvida, quando chega mensagem do cliente e quando um contato é criado ou atualizado. Cada aviso vai assinado, e se o seu sistema estiver fora do ar, o Flagy tenta de novo.
API de conversasListar, abrir, ler e enviar mensagens e mudar a situação da conversa.
API de contatosConsultar e cadastrar contatos a partir do seu sistema.
Chaves com permissãoCada chave só faz o que você liberou e pode ser revogada quando quiser.
Webhooks de eventosConversa criada, transferida ou resolvida, mensagem recebida, contato criado ou atualizado.
Aviso assinadoO seu sistema confere a assinatura e sabe que o aviso veio do Flagy.
Nova tentativaSe o seu sistema não responder, o aviso é reenviado depois.
Bloco de requisição no fluxoO próprio chatbot chama a sua API no meio da conversa e guarda a resposta.