Ir para o conteúdo principal

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": "..."
}
cautela

Enviaremos o webhook exatamente uma vez para cada postagem, mesmo que recebamos uma resposta negativa dos seus servidores. Caso seus servidores não consigam processar o evento do webhook, você poderá obter os dados de todas as suas postagens geradas. Saiba mais aqui.

Teste em ambiente local​

Não é possível usar o localhost diretamente para receber estados de webhook, pois a URL do webhook precisa ser pública. Você pode contornar isso criando um túnel para o seu servidor local usando ferramentas como o ngrok . Utilize o endpoint da URL gerado por essas ferramentas na URL do webhook ao configurar a URL do webhook no painel de controle.

Recursos adicionais​