Configurando webhooks
Todas as postagens criadas via Predis.ai API têm um ciclo de vida e assumem estados diferentes. Os possíveis estados que uma postagem pode assumir são inProgress, completed e error. Uma vez feita uma solicitação para gerar uma postagem, o inProgress state é notificado na própria resposta. Os dois estados restantes - completed e error será notificado através dos webhooks configurados por você.
Configure um URL de webhook
Siga as etapas abaixo para configurar o URL do seu webhook no API painel de controle:
- Entre para Predis.ai app
- Navegue até Preços e Conta -> Resto API para abrir o API painel de instrumentos
- Adicione o URL do seu webhook. Certifique-se de que o URL do webhook seja um URL público.
Carga útil do webhook
Se a postagem atingiu um completed or error estado, um webhook será enviado com a carga contendo os seguintes parâmetros:
completed carga útil do estado
{
"status": "completed",
"caption": "...",
"post_id": "...",
"generated_media": [{"url": "..."}],
"brand_id": "..."
}
error carga útil do estado
{
"status": "error",
"post_id": "..."
}
Enviaremos o webhook exatamente uma vez para cada postagem, mesmo se recebermos uma resposta sem sucesso de seus servidores. Caso seus servidores não consigam lidar com o evento webhook, você poderá obter os dados de todas as postagens geradas. Leia mais sobre isso aqui
Teste em ambiente local
Não é possível usar localhost diretamente para receber estados de webhook, pois a URL do webhook deve ser uma URL pública. Você pode lidar com isso criando um túnel para seu servidor local usando ferramentas como grok. Use o endpoint de URL gerado por essas ferramentas no URL do webhook ao configurar o URL do webhook no painel.